API 레퍼런스
이미지: 즉시 반환
아직 지원하는 모델이 없습니다
현재 모델 목록에서 이 경로를 지원하는 모델이 없습니다. 이 페이지는 참고용으로 남겨 둡니다.
POST
/v1/images/generations이 경로를 지원하는 모델용 동기식 이미지 생성으로, OpenAI 형식의 본문 하나로 요청합니다. 응답에 최종 이미지 URL이 담깁니다.
#요청 파라미터
modelstring필수이 동기 경로를 지원하는 이미지 모델. 작업 전용 모델은 거부합니다 — /v1/images/tasks를 사용하세요.
promptstring필수그릴 내용.
ninteger선택이미지 수(이미지 수만큼 과금이 곱해집니다).
sizestring선택화면 비율 프리셋(예: "16:9"). 대부분의 이미지 모델이 이 형식을 사용하며, 정확한 값은 모델 카드에 나와 있습니다. 일부 구형 모델은 WIDTHxHEIGHT도 받습니다.
resolutionstring선택출력 해상도 구간(예: "1K", "2K", "4K"). 모델 카드에 나와 있을 때 지정할 수 있습니다 — 요금 구간 기준이기도 합니다.
qualitystring선택제공업체 품질 수준(예: standard / hd) — 요금 구간 기준이기도 합니다.
response_formatstring선택"url"(기본값) 또는 인라인 바이트용 "b64_json".
구간별 요금
size, quality, duration이 과금 구간을 결정합니다 — 모델 카드에 구간별 정확한 가격이 있으며, 실패한 호출은 자동 환불됩니다.
#관련 오류
- 422 unprocessable_entity게이트웨이가 전달한 파라미터 값을 제공업체가 거부했습니다(예: 지원하지 않는 크기나 길이).
- 401Bearer 토큰이 유효하지 않거나 없습니다. 이 경로에는 error.code가 없으므로 상태 코드로 판단하세요.
- 402 insufficient_user_quota지갑 잔액이 사전 차감 추정액보다 부족합니다.
- 429키별 속도 제한입니다. 본문은 비어 있으며 Retry-After만큼 기다리세요. insufficient_user_quota가 포함된 429는 속도 제한이 아니라 일일 지출 한도입니다.
- 503 model_not_found알 수 없는 모델이거나, 현재 이 모델을 제공하는 정상 채널이 없습니다.
#요청 예시
curl https://www.aisplice.store/v1/images/generations \
-H "Authorization: Bearer sk-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_SYNC_IMAGE_MODEL",
"prompt": "A cyberpunk skyline at dusk, neon rain",
"size": "1:1"
}'#응답
response.json
{
"created": 1720000000,
"data": [{"url": "https://…"}]
}아직 해결되지 않았나요?
요청 ID나 오류 메시지를 보내 주시면 확인해 드리겠습니다.