🎉 각 팩 첫 구매 시 무료 생성 선물 — 최대 Lite 영상 20개 + Lite 이미지 20개 + Medium 영상 10개 + Pro 이미지 10개 + Pro 영상 2개.

시작하기
DreamUtopia
ko

오류 및 제한

모든 실패는 하나의 봉투를 사용합니다. 코드는 안정적이며, 메시지는 사용자에게 표시할 수 있는 영어 폴백입니다.

응답
{
  "error": {
    "code": "insufficient_credits",
    "message": "You need more credits to generate."
  }
}

상태

  • 400

    일반적인 코드
    invalid_request, prompt_too_long, invalid_reference_image
    무엇을 해야 할까요
    요청을 수정하세요; 변경 없이 재시도하지 마세요
  • 401

    일반적인 코드
    unauthorized
    무엇을 해야 할까요
    키를 확인하세요. 루프에서 재시도하지 마세요
  • 402

    일반적인 코드
    insufficient_credits
    무엇을 해야 할까요
    크레딧을 충전하세요. 절대 재시도하지 마세요
  • 403

    일반적인 코드
    unauthorized
    무엇을 해야 할까요
    미결제 키 생성 또는 프리미엄 없이 요청된 오디오
  • 404

    일반적인 코드
    not_found
    무엇을 해야 할까요
    알 수 없는 작업이거나 이 계정의 작업이 아닙니다
  • 409

    일반적인 코드
    invalid_request
    무엇을 해야 할까요
    Idempotency-Key 충돌이 발생했습니다. 새 키를 사용하세요.
  • 413 / 415

    일반적인 코드
    invalid_request / unsupported_image_type
    무엇을 해야 할까요
    더 작은 JPEG, PNG 또는 WebP를 업로드하세요
  • 429

    일반적인 코드
    rate_limited
    무엇을 해야 할까요
    Retry-After를 기다리세요
  • 500 / 503

    일반적인 코드
    internal
    무엇을 해야 할까요
    백오프로 재시도

실패한 생성은 status: "failed"와 코드 internal의 error 객체를 포함한 200 작업 응답입니다. 완료된 작업은 종료 상태이므로 다시 제출하지 마세요.

재시도 정책

  • HTTP 429, timeout 및 internal 응답만 재시도하세요.
  • insufficient_credits는 절대 재시도하지 말고, 이미 failed로 종료된 작업은 절대 다시 제출하지 마세요.
  • 생성 시 Idempotency-Key를 사용하여 재시도로 인해 두 번 청구되지 않도록 하세요.
  • 약 1초부터 시작하여 지터를 더해 지수적으로 백오프하세요.

속도 제한

한도는 별도 표기가 없는 한 고정 1분 단위 시간 창에서 키별로 적용됩니다. 기본값:

  • 60 요청/분 전체.
  • 분당 10회 생성.
  • 분당 5회 업로드.
  • 클라이언트 IP당 분당 GET /v1/models 요청 120회(해당 경로는 공개됨).
  • 계정당 시간당 API 키 생성 5회.

429에는 X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset 및 Retry-After가 포함됩니다.

가용성

/v1을 일시적으로 사용할 수 없으면 모든 경로가 코드 internal과 함께 503으로 응답합니다. 잠시 후 백오프하며 다시 시도하세요.

© 2026 DreamUtopia. 모든 권리 보유.