API Reference
개요
비동기 이미지 API의 엔드포인트와 규약입니다.
기본 URL
https://api.seedrouter.aiHTTPS를 사용하고 Bearer API 키로 인증하세요. 요청과 작업 응답은 모두 JSON 형식입니다.
엔드포인트
| 메서드 | 경로 | 용도 |
|---|---|---|
| POST | /v1/images/generations | 이미지 생성 또는 편집 작업을 제출합니다. |
| GET | /v1/tasks/{id} | 작업 상태와 결과를 조회합니다. |
여기서 설명하는 규약은 이 문서가 다루는 이미지 작업 API에 해당합니다. 지원되는 파라미터는 각 모델의 레퍼런스를 확인하세요.
요청 수명 주기
요청을 제출하고 반환된 id를 저장한 뒤, status가 completed 또는 failed가 될 때까지 해당 ID를 폴링하세요. 제출 시점에는 이미지 자체가 반환되지 않습니다.
완료되면 이미지 URL은 output.data[].url에 담깁니다. 실패한 경우 error.code와 error.message를 확인하세요. 실패한 작업은 과금되지 않습니다.