이미지 생성

POST /v1/images/generations은 작업이 아니라 한 번의 응답으로 답합니다. modelprompt는 필수이고, n·size·quality는 선택이며 생략하면 각 모델의 기본값을 씁니다. 응답은 {"created": …, "data": [ … ]}이고 각 항목은 url을 담습니다. b64_json은 존재하지만 "response_format": "b64_json"으로 요청하지 않으면 비어 있습니다. 기존 이미지를 편집하려면 원본을 image에 담아 POST /v1/images/edits로 보냅니다. 과금은 생성된 이미지 한 장 단위라서 n이 그대로 요금의 배수가 됩니다.

POST /v1/images/generations
curl https://api.chinaapi.ai/v1/images/generations \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "image-01",
    "prompt": "a red paper crane on a white desk, soft daylight",
    "n": 1
  }'

# {"created":1786620000,
#  "data":[{"url":"https://.../image_inference_output/....jpg","b64_json":""}],
#  "metadata":{"success_count":"1","failed_count":"0"}}
4K 출력

doubao-seedream-5-0-260128

doubao-seedream-4-5-251128도 같습니다. 둘 다 4K까지 지원하고 편집과 다중 이미지 합성을 위해 입력 이미지를 받으므로, size는 기본값에 맡기지 말고 명시하는 편이 좋습니다.

범용

wan2.7-image

wan2.7-image-pro도 같으며, 이쪽은 약 두 배 가격에 4K 등급이 더해집니다. 요청 필드는 이 엔드포인트의 다른 모델과 같고, 출력물을 인쇄하거나 확대할 예정이라면 pro를 고르세요.

편집과 저비용

step-image-edit-2

step-2x-largeimage-01도 같습니다. step-image-edit-2는 사용자가 준 이미지를 편집하는 데 맞춰져 있고 셋 중 가장 저렴하며, image-01은 이 엔드포인트에서 가장 저렴한 텍스트-투-이미지 모델입니다.

이 엔드포인트는 토큰이 아니라 호출 단위로 과금하고 그 가격에 이미지 한 장이 포함됩니다. 사용 로그에 프롬프트 토큰이 1로 기록되는데 이는 장부상의 값일 뿐 프롬프트 길이를 나타내지 않습니다. "n": 4는 이미지 한 장의 네 배 요금입니다. 여기 모델들은 가격이 한 자릿수 이상 차이 나므로 프롬프트를 다듬기 전에 모델부터 고르세요.