

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-proprompt와 함께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 레퍼런스에서 확인할 수 있습니다.

핵심 요약
- 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장 |
