인증
Authorization 헤더에 Bearer 토큰을 넣습니다. 키는 설정에서 만듭니다.
Authorization: Bearer YOUR_API_KEY개발자 · API v1하나의 API.
하나의 API.
모든 모델.
이미지, 영상, 오디오, 3D를 하나의 API로, 스튜디오와 같은 잔액에서 결제됩니다. 키는 설정에서 만드세요. CLI는 곧 출시됩니다.
출시 예정CLI와 SDK는 곧 출시됩니다. 아래 REST API는 지금 바로 사용할 수 있습니다.
- 모델
- 672
- 엔드포인트
- 9
- 최소 충전
- €3
01 · 예제
같은 호출, 어떤 결과든
모델 ID만 바꾸면 이미지, 영상, 음성을 오갈 수 있습니다. 필드는 모델에 따라 달라집니다.
1# 1. Generate an image2curl -X POST https://femimg.com/api/v1/api/catalog/generations \3 -H "Authorization: Bearer $FEMIMG_API_KEY" \4 -H 'Content-Type: application/json' \5 -H "Idempotency-Key: $(uuidgen)" \6 -d '{7 "modelId": "luma/uni-v1/text-to-image",8 "inputs": {9 "prompt": "Neon city street after rain, cinematic night",10 "size": "16:9"11 }12}'13 14# 2. Poll with the generation id from step 1 until its status is succeeded15curl https://femimg.com/api/v1/api/catalog/generations/$ID \16 -H "Authorization: Bearer $FEMIMG_API_KEY"17 18# 3. Download the file19curl https://femimg.com/api/v1/api/catalog/generations/$ID/content \20 -H "Authorization: Bearer $FEMIMG_API_KEY" \21 -o result.jpeg
02 · 빠른 시작
세 단계로 첫 렌더
- 01API 키 만들기설정 > API 키에서 키 이름을 정하고 한 번 복사하세요. 결제에서 €3부터 충전할 수 있습니다.
export FEMIMG_API_KEY="YOUR_API_KEY" - 02렌더 시작모델 ID와 입력을 보내면 queued 상태의 생성 작업이 바로 돌아옵니다.
POST /api/v1/api/catalog/generations - 03상태 확인 후 다운로드상태가 succeeded가 될 때까지 확인한 뒤 파일을 내려받으세요.
GET /api/v1/api/catalog/generations/ID/content
03 · CLI출시 예정
터미널에서 렌더
스크립트, CI, 코딩 에이전트를 위한 명령줄 도구가 준비 중이며 API와 같은 키와 잔액을 씁니다. 출시 전까지 이 페이지의 모든 호출은 curl로 사용할 수 있습니다.
스크립트와 CI어떤 셸, 작업, cron에서든 렌더합니다.
JSON 출력실행마다 JSON 문서 하나, 다음 단계에 바로 쓸 수 있습니다.
코딩 에이전트에이전트가 먼저 가격을 확인하고 지출 상한을 둡니다.
04 · API 핵심
프로덕션을 위해 설계
백그라운드 렌더
렌더를 시작하면 바로 queued 상태가 돌아옵니다. succeeded, failed, refunded가 될 때까지 확인하세요.
{ "status": "queued" }가격 먼저
아무것도 시작하지 않고 입력에 대한 정확한 가격을 조회합니다. 모든 금액은 유로 센트 단위입니다.
POST /api/v1/api/catalog/quote안전한 재시도
Idempotency-Key 헤더를 보내면 재시도한 요청이 두 번 과금되지 않습니다.
Idempotency-Key: render-042제한
키마다 분당 요청 한도가 있으며, 넘으면 429 오류가 반환됩니다.
429 Too Many Requests오류와 환불
코드와 메시지가 담긴 JSON 오류. 실패한 렌더는 자동으로 잔액에 환불됩니다.
{ "status": "refunded" }05 · 레퍼런스
엔드포인트
기본 URL https://femimg.com/api/v1
GET
/api/catalog/me키 이름, 한도, 내 잔액GET
/api/catalog/models가격이 포함된 모델 카탈로그GET
/api/catalog/models/detail?id=MODEL_ID모델 하나와 모든 필드POST
/api/catalog/quote입력에 대한 정확한 가격POST
/api/catalog/generations아무 모델로 렌더 시작GET
/api/catalog/generations최근 생성 작업GET
/api/catalog/generations/ID생성 작업 하나의 상태, 비용, 결과GET
/api/catalog/generations/ID/content완성된 파일 다운로드DELETE
/api/catalog/generations/ID생성 작업 삭제€3 충전하고 오늘 바로 시작
API와 스튜디오는 하나의 잔액을 함께 씁니다. 실패한 렌더는 환불됩니다.