이미지

이미지 생성은 문서 탐색에 표시되므로 해외 문서에서는 일관된 제품 맵을 유지합니다. 공용 해외 엔드포인트 가용성은 스키마 기반입니다. 프로덕션 코드에서 이미지 엔드포인트를 호출하기 전에 GET /api/openapi.json를 확인하세요.

요구

이미지 엔드포인트가 활성화되면 비동기 작업 모델이 예상됩니다. 프롬프트와 모델 옵션을 사용하여 작업을 생성한 다음 완료를 위해 폴링합니다. 요청은 여전히 ​​전달자 인증을 사용합니다.

Authorization: Bearer KITTA_API_KEY

다른 문서에서 해외 경로를 추론하지 마세요. 배포된 환경에는 해외 OpenAPI 스키마에 있는 경로만 사용하세요.

응답

이미지 작업 응답에는 일반적으로 작업 ID, 상태, 성공 시 결과 이미지 URL, 실패 시 오류 코드가 포함됩니다. 페이지를 새로 고치거나 작업자를 다시 시작한 후 사용자가 결과를 복구할 수 있도록 폴링하기 전에 작업 ID를 저장합니다.

청구 및 크레딧

이미지 생성에는 모델, 해상도, 참조 이미지 또는 성공적인 작업에 따라 요금이 부과될 수 있습니다. 작업을 생성하기 전에 프롬프트 크기와 입력 미디어를 확인하고 대규모 배치 전에 프로필을 확인하세요.

오류

지원되지 않는 모델, 유효하지 않은 참조 이미지, 크레딧 부족, 처리 실패 등을 별도로 처리합니다. GET /api/openapi.json에 이미지 엔드포인트가 없는 경우 해당 기능을 계정에 공개적으로 사용할 수 없는 것으로 처리합니다.

공식 OpenAPI 엔드포인트

• 모델 목록: GET /api/open/v1/media/models?mediaType=image
• 이미지 생성: POST /api/open/v1/media/images/jobs
• 작업 조회: GET /api/open/v1/media/images/jobs/{jobId}

각 생성 요청에는 고유한 Idempotency-Key 헤더가 필요합니다. 이 API는 웹 멤버십 크레딧이 아닌 API 쿼터를 사용하며 공급자, 저장소 또는 작업 저장 실패 시 쿼터를 멱등하게 환불합니다.