Images API: Seedream 이미지 생성

Seedream 이미지 생성 엔드포인트입니다. 프롬프트를 보내면 결과 이미지 URL을 동기 응답으로 돌려줍니다. URL은 임시 주소이므로 생성 직후 저장해야 합니다. 요금은 모델과 해상도에 따라 달라지며, 최신 단가는 Tokuse 요금 페이지에서 확인하세요.

엔드포인트와 인증

항목	값
메서드	POST
엔드포인트	/v1/images/generations
인증	Authorization: Bearer sk-your-tokuse-key
모델	Seedream
응답 방식	동기 (이미지 URL 반환)

지원 모델

이미지 생성은 Seedream 모델을 사용합니다. 해상도와 파라미터 지원 범위는 사용하는 모델 버전에 따라 다르므로 Tokuse 콘솔의 모델 정보를 확인하세요.

요청 예시

curl https://tokuse.com/v1/images/generations \
  -H "Authorization: Bearer sk-your-tokuse-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Seedream",
    "prompt": "비 오는 서울의 야경, 시네마틱 조명",
    "size": "1024x1024"
  }'

응답 예시

{
  "created": 1763200000,
  "data": [
    {"url": "https://.../generated-image.png"}
  ]
}

주의 사항과 제한

• 응답의 이미지 URL은 임시 주소입니다. 만료되기 전에 내려받아 저장하거나 직접 업로드하세요.
• size는 1024x1024처럼 지정합니다. 지원 해상도는 모델에 따라 다릅니다.
• 프롬프트와 해상도에 따라 생성 시간이 달라집니다. 긴 요청은 클라이언트 타임아웃을 넉넉하게 설정하세요.
• 생성 결과를 서비스에 오래 보관하려면 URL을 그대로 저장하지 말고 파일을 복사해 두세요.

요금

이미지 생성은 모델과 해상도에 따라 단가가 달라집니다. 같은 프롬프트라도 해상도가 높아지면 비용이 늘어날 수 있습니다. 실제 단가는 Tokuse 요금 페이지(/pricing)와 업스트림 콘솔에서 확인하세요.