메인 콘텐츠로 건너뛰기
POST
생성 시작

인증

Authorization
string
header
필수

Authorization: Bearer <API 키>

헤더

Idempotency-Key
string

같은 키로 다시 보내면 첫 작업을 돌려주고 다시 청구하지 않아요. 공백 없는 ASCII 255자까지예요.

Maximum string length: 255
Accept-Language
string

ko면 메시지를 한국어로 줘요. 기본은 영어예요.

본문

application/json
model
string
필수

모델 ID예요. GET /models에서 볼 수 있어요.

Minimum string length: 1
prompt
string

만들 내용이에요. 필요한지는 모델의 inputs.prompt에 나와 있어요.

Maximum string length: 10000
params
object

모델 옵션이에요. 빼면 기본값을 쓰고, 모델에 없는 값은 400으로 거절해요.

inputs
object

응답

작업을 받았어요. terminal이 true가 될 때까지 조회해 주세요.

id
string<uuid>
필수
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
status
enum<string>
필수
사용 가능한 옵션:
queued,
running,
succeeded,
failed,
canceled
terminal
boolean
필수

true면 더 바뀌지 않아요. 이때 조회를 멈추면 돼요.

model
string
필수
model_name
string
필수
modality
enum<string>
필수
사용 가능한 옵션:
image,
video,
remix
prompt
string | null
필수

삭제한 작업은 null이에요.

params
object
필수

실제로 적용한 옵션이에요. 기본값도 들어 있어요.

price_usd
string
필수

달러 금액이에요. 오차가 없도록 소수 넷째 자리까지 쓴 문자열로 줘요.

Pattern: ^\d+\.\d{4}$
created_at
string
필수

ISO 8601 시각이에요.

deleted_at
string | null
필수

삭제한 시각이에요. 삭제 전에는 null이에요.

error
object | null
필수

failed일 때만 있어요. 금액은 돌려드려요.

outputs
object[]
필수