Rivya Public API v1에서 Seedream 5.0 Pro을 모델 ID seedream-5-pro, 지원 입력, 파라미터, Files API 규칙, 크레딧, 응답 예시와 함께 사용하세요.

API로 사용 가능텍스트 또는 URL 준비됨; 참조 모드는 Files API 사용이미지

API 모델 ID

seedream-5-pro

입력

text, file

Files API

참조 모드에 필요

기본 크레딧

크레딧은 입력과 설정에 따라 달라집니다. 생성 전에 예상 비용을 확인하세요. 최종 작업 비용은 정수 크레딧으로 올림 처리됩니다.

기능

이미지

과금

FIXED

프롬프트 제한

5000 자

요청 계약

모델 ID는 최상위 수준에 보냅니다. 모델별 제어값은 params에 넣습니다.

Key	유형	필수	기본값	설명
model	string	예	seedream-5-pro	seedream-5-pro을 API 모델 ID로 사용합니다.
prompt	string	예	-	이 모델은 최대 5000자까지 사용할 수 있습니다.
params	object	아니요	-	모델별 파라미터 객체입니다. 허용되는 키는 아래 행을 확인하세요.
client_request_id	string	아니요	-	자체 시스템에서 요청을 추적하기 위한 선택적 클라이언트 ID입니다.

모델 파라미터

Key	유형	필수	기본값	범위	옵션	설명
aspect_ratio	select	아니요	1:1	-	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9	화면비
quality	select	아니요	basic	-	basic, high	품질
output_format	select	아니요	png	-	png, jpeg	출력 형식
nsfw_checker	select	아니요	false	-	false, true	모델의 선택형 콘텐츠 필터를 활성화합니다. 자동 필터는 완전한 감지를 보장할 수 없습니다.

업로드 정책

참조 파일을 먼저 업로드한 다음 반환된 URL과 durationToken을 params.referenceMediaItems 안에 넣으세요.

참조 규칙

참조 이미지: JPEG, PNG 또는 WebP 이미지를 최대 10장까지 업로드하세요. 각 이미지는 10MB 이하여야 합니다.

최대 파일 수

허용되는 파일 종류

image

재생시간 토큰

재생시간 검증이 필요한 경우 비디오 및 오디오 참조는 /api/v1/files의 durationToken을 포함해야 합니다.

kind	최대 크기	MIME 유형
image	10 MB	image/jpeg, image/png, image/webp

최소 요청

{
  "model": "seedream-5-pro",
  "prompt": "밝은 회색 배경 앞에 놓인 제품이 담긴 병. 왼쪽에서 부드러운 빛이 비친다.",
  "params": {
    "aspect_ratio": "1:1",
    "quality": "basic",
    "output_format": "png",
    "nsfw_checker": "false"
  }
}

참조 파일 요청

{
  "model": "seedream-5-pro",
  "prompt": "밝은 회색 배경 앞에 놓인 제품이 담긴 병. 왼쪽에서 부드러운 빛이 비친다.",
  "params": {
    "aspect_ratio": "1:1",
    "quality": "basic",
    "output_format": "png",
    "nsfw_checker": "false",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

생성 응답

생성 엔드포인트는 공개 작업 ID를 반환합니다. 작업이 성공하거나 실패할 때까지 상태 엔드포인트를 폴링하세요.

{
  "id": "task_seedream_5_pro_example",
  "status": "queued",
  "model": "seedream-5-pro",
  "reserved_credits": 7,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

일반 오류

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

일부 모드는 Files API 참조 업로드가 필요합니다.

Seedream 5.0 Pro API 연동