API 콘솔

Fellowi Images 생성기를 직접 코드에서 호출하세요. 모델도, 가격도, 코인 지갑도 동일하며 웹 폼 대신 API 키를 사용할 뿐입니다.

인증

모든 요청에는 Authorization 헤더에 API 키가 필요합니다: Authorization: Bearer fk_live_.... 키는 아래에서 생성되며 생성 직후 단 한 번만 표시되니 안전한 곳에 보관하세요.

내 API 키

API 키

키를 붙여 넣으면 이 페이지의 모든 예제에 들어가고, 여기서 바로 API를 사용해 볼 수 있습니다. 키는 이 브라우저 탭에만 남고 이 사이트의 API로만 전송됩니다.

이 탭에서 기억하기

모델

model 필드로 모델을 고릅니다. 가격은 이미지 한 장당 Fellowi 코인이며 웹 Image Studio와 완전히 같습니다. images가 비어 있으면 text-to-image이고, 참조 이미지를 보내면 편집 모델로 실행되어 요금이 달라질 수 있습니다.

model을 생략하면 fellowi-text-to-image이 사용됩니다. 선택지가 생기기 전에 작성된 연동이 늘 쓰던 그 모델, 그 가격 그대로입니다.

curl https://fellowi.com/api/v1/api/models

이미지 생성하기

POST /v1/api/images는 대기열에 들어간 생성과 함께 즉시 202를 반환합니다. 이미지 자체는 몇 분까지 걸릴 수 있습니다. Idempotency-Key 헤더를 보내면 재시도로 두 번 결제되는 일이 없습니다.

images는 선택 사항입니다. 모델이 참고할 공개 이미지 URL을 최대 10개까지 넣을 수 있습니다 (컴패니언 사진, 직접 준비한 참조 이미지). 하나당 10 코인이 더해지고, 목록이 비어 있지 않으면 text-to-image 대신 편집 모델로 실행됩니다.

curl -X POST https://fellowi.com/api/v1/api/images \
  -H "Authorization: Bearer fk_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "prompt": "a neon-lit cyberpunk portrait",
    "model": "fellowi-text-to-image",
    "quality": "standard",
    "format": "png",
    "aspectRatio": "1:1",
    "enhancePrompt": false,
    "enhanceStyle": "default",
    "images": []
  }'

요청 옵션

아래는 모두 선택 사항입니다. 각 기본값은 해당 옵션이 없던 시절의 동작과 같으므로, 예전에 만든 연동은 그대로 계속 동작합니다.

quality: standard 또는 high. 해상도와 가격을 정합니다 - 위 표를 보세요.
format: png 또는 jpeg. 기본값은 png입니다.
aspectRatio: auto (기본값) 또는 1:1, 3:4, 4:3, 2:3, 3:2, 4:5, 5:4, 16:9, 9:16, 2:1, 1:2, 3:1, 1:3, 21:9, 9:21 중 하나.
enhancePrompt / enhanceStyle: enhancePrompt를 true로 두면 렌더링 전에 프롬프트가 다시 작성되며, 10 코인이 추가됩니다. enhanceStyle은 그 방향을 정합니다: default, artistic, photographic, technical, anime, realistic. enhancePrompt가 꺼져 있으면 무시됩니다.
images: 참고할 공개 이미지 URL을 최대 10개. 하나라도 보내면 요청이 편집 모델로 바뀝니다. images의 참조 이미지는 하나당 10 코인이 추가됩니다.

결과 폴링하기

status가 succeeded가 될 때까지 GET /v1/api/images/{id}를 폴링한 뒤 imageUrl을 내려받으세요. 실패한 생성은 자동으로 환불됩니다.

curl https://fellowi.com/api/v1/api/images/{id} \
  -H "Authorization: Bearer fk_live_..."

생성이 실패하면

실패한 생성은 코인을 환불하고 failureCode에 네 가지 중 하나를 담습니다: TIMEOUT, MODERATION_REJECTED, VENDOR_ERROR, UNKNOWN. 더 구체적인 것은 공개하지 않습니다 - 내부 코드는 여러분의 요청이 아니라 저희 파이프라인에 대한 이야기가 되기 때문입니다.

요청 제한과 비용

키마다 분당 요청 수 제한이 있고 (아래 패널에서 볼 수 있습니다) 일일 코인 상한을 둘 수도 있습니다. 이것은 남용 방지 장치일 뿐 진짜 한계가 아닙니다 - 실제로 몇 장을 만들 수 있는지는 Fellowi 코인 잔액이 정합니다. HTML 페이지가 포함된 403: 요청이 API에 닿기 전에 차단되었습니다. 대개 User-Agent 때문입니다. Python-urllib 기본값은 차단되므로 직접 지정하세요(예: User-Agent: my-app/1.0).