엔드포인트/Media

미디어 작업 가져오기

id로 비동기 미디어 작업의 상태와 결과를 가져옵니다. 상태가 succeeded 또는 failed가 될 때까지 이 엔드포인트를 폴링하세요.

GEThttps://api.foxwire.ai/v1/media/generations/{id}

#인증

모든 요청은 Authorization 헤더에 키를 담습니다.

http

Authorization: Bearer sk-corr-...

매개변수	유형	필수	설명
`id`	string	예	작업 생성 엔드포인트가 반환한 작업 id.

bash

curl https://api.foxwire.ai/v1/media/generations/task_abc123 \
  -H "Authorization: Bearer $CORRY_KEY"

작업 객체를 반환합니다. 일반적인 필드:

필드	유형	설명
`id`	string	미디어 작업 가져오기 id
`status`	string	작업 상태: queued / submitted / succeeded / failed / timeout.
`type`	string	미디어 유형: image / video / music.
`model`	string	요청한 모델.
`result.urls`	string[]	성공 시 존재합니다. result.urls는 영구 파일 URL의 배열입니다.
`error`	string	오류 메시지. 작업이 실패했을 때 존재합니다.
`cost`	string	이 작업에 청구된 금액 — USD 문자열(예: "0.1200"). currency 필드를 참고하세요.

응답 예시

{
  "id": "task_abc123",
  "status": "running",
  "type": "image",
  "model": "gpt-image-2"
}

status	설명
`queued`	대기열에 있으며 시작을 기다리는 중입니다.
`running`	업스트림 제공업체에서 생성 중입니다.
`succeeded`	완료 — result.urls를 사용할 수 있습니다.
`failed`	실패 — error를 참고하세요. 보류 금액은 자동으로 환불됩니다.

성공 시 존재합니다. result.urls는 영구 파일 URL의 배열입니다.

상태	의미
`401`	키가 유효하지 않거나 없습니다
`404`	요청한 모델이 존재하지 않거나 사용할 수 없습니다

json

{
  "error": {
    "message": "Task not found",
    "type": "not_found"
  }
}