APIMart
GccAi

Seedream 5.0 Pro로 이미지 생성하는 방법

APIMart에서 Seedream 5.0 Pro를 호출하는 단계별 가이드: 인증, 요청 필드, 작업 폴링, 결과 읽기, 링크 만료 전 이미지 저장.

튜토리얼

Seedream 5.0 Pro는 POST 요청 한 번, API 키 하나, 그리고 후속 단계 하나로 동작합니다. 작업을 제출해 task_id를 받은 다음, 이미지가 완성될 때까지 작업을 확인하면 됩니다. Seedream 5.0 Pro는 비동기 모델이라 첫 응답에는 이미지가 들어 있지 않습니다.

짧게 정리하면:

  • 요청 주소는 https://api.apimart.ai/v1/images/generations
  • 헤더에 Authorization: Bearer YOUR_API_KEY 추가
  • model은 seedream-5-0-pro
  • prompt와 함께 resolution(1K, 1.5K, 2K)과 size(auto 또는 16:9 같은 비율) 지정
  • 편집하거나 합성할 때는 image_urls에 참조 이미지를 최대 10장 추가
  • GET /v1/tasks/{task_id}를 5~10초마다 폴링해 상태가 completed가 될 때까지 대기
  • 이미지 링크는 72시간 동안만 유효하므로 결과를 바로 다운로드

가장 기억할 점: 이 모델은 단일 이미지 모델입니다. 요청 한 번에 이미지 한 장만 반환되며, n이 1보다 크면 거부됩니다. APIMart에서 Seedream 5.0 Pro API를 사용해 볼 수 있고, 전체 필드는 API 레퍼런스에서 확인할 수 있습니다.

GccAi
Seedream 5.0 Pro API: 요청과 폴링 요약표

핵심 요약

  • Seedream 5.0 Pro는 https://api.apimart.ai/v1/images/generations로 POST 요청을 보내 호출합니다. 헤더는 Authorization: Bearer YOUR_API_KEY, model은 seedream-5-0-pro입니다.
  • 출력 등급은 resolution(1K, 1.5K, 2K)으로, 형태는 size(auto, 10가지 비율 중 하나, 또는 정확한 픽셀)로 정합니다. 1.5K는 1K와 가격이 같고, 3K와 4K는 400을 반환합니다.
  • 요청마다 이미지는 한 장만 생성됩니다. n이 1보다 큰 요청, 그룹 생성, 스트리밍, 웹 검색은 모두 400으로 거부되며 작업이 생성되지 않습니다.
  • 이미지 편집은 image_urls로 참조 이미지를 최대 10장, 공개 URL 또는 Base64 데이터 URI로 보냅니다.
  • 첫 응답에는 task_id만 들어 있습니다. 작업 엔드포인트를 5~10초마다 폴링하고, 72시간 안에 이미지를 저장하세요.

빠른 비교

항목용도주요 제한 또는 참고
텍스트-투-이미지프롬프트만으로 새 이미지 생성입력 이미지 불필요
단일 참조 편집이미지 한 장의 배경, 조명, 디테일 변경image_urls에 1장