Руководство по интеграции API генерации изображений SeeDream

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Процесс подачи заявки

​

Основное использование

• accept: формат ожидаемого ответа. Здесь установлено в application/json (JSON).
• authorization: API-ключ, который можно выбрать из выпадающего меню после подачи заявки.

• prompt: текстовое описание идеи для изображения.
• model: модель генерации, по умолчанию doubao-seedream-5.0-lite. Поддерживаются модели: doubao-seedream-5.0-lite (последняя версия), doubao-seedream-4.5, doubao-seedream-4.0, doubao-seedream-3.0-t2i, doubao-seededit-3.0-i2i.
• image: информация о входных изображениях, поддерживаются URL или Base64. Для моделей doubao-seedream-5.0-lite, 4.5, 4.0 допускается как одиночное, так и множественное изображение; doubao-seededit-3.0-i2i — только одно изображение; модель doubao-seedream-3.0-t2i не использует этот параметр.
• size: задает размер создаваемого изображения двумя способами, несовместимыми друг с другом. Способ 1 | Задание разрешения и описание в promptNatural Language для соотношения сторон изображения. Поддержка предустановок различается по моделям: doubao-seedream-5.0-lite — 2K/3K/4K; doubao-seedream-4.5 — только 2K/4K; doubao-seedream-4.0 — 1K/2K/4K; doubao-seedream-3.0-t2i и doubao-seededit-3.0-i2i — только способ 2. Способ 2 | Задание ширины и высоты в пикселях, например 2048x2048. Минимальный размер зависит от модели (например, для 5.0 / 4.5 — 3 686 400 пикселей, для 4.0 — 921 600, для 3.0-t2i / seededit-3.0-i2i — диапазон [512x512, 2048x2048]).
• seed: число-семя для контроля случайности вышеуровневой генерации. В диапазоне [-1, 2147483647]. Поддерживается только модель doubao-seedream-3.0-t2i.
• sequential_image_generation: набор связанных изображений на базе введенного текста. doubao-seedream-5.0-lite, 4.5, 4.0 — поддерживают, по умолчанию disabled.
• stream: включение потоковой выдачи. doubao-seedream-5.0-lite, 4.5, 4.0 — поддерживают, по умолчанию false.
• guidance_scale: степень соответствия результата prompt, чем больше — тем ближе. Диапазон [1, 10]. Значения по умолчанию: 2.5 для doubao-seedream-3.0-t2i, 5.5 для doubao-seededit-3.0-i2i. Не поддерживается другими моделями.
• response_format: желаемый формат возвращаемого изображения. По умолчанию url, поддерживаются также b64_json.
• watermark: добавлять водяной знак на изображение. По умолчанию true.
• output_format: формат файла изображения (jpeg — по умолчанию, или png). Поддерживается только doubao-seedream-5.0-lite.
• tools: инструменты, вызываемые моделью (например, web_search для онлайн-поиска). Только для doubao-seedream-5.0-lite.
• callback_url: URL для получения асинхронного результата.

curl -X POST 'https://api.xhuoapi.ai/v1/seedream/images' \
-H 'accept: application/json' \
-H 'authorization: Bearer ${token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "model": "doubao-seedream-4-0-250828",
  "prompt": "a white siamese cat"
}'

​

Задачи редактирования изображений

• model: модель для редактирования (doubao-seedream-5.0-lite, 4.5, 4.0) — поддерживают одно или несколько изображений; doubao-seededit-3.0-i2i — только одно изображение.
• image: одно или несколько изображений для редактирования.

import requests

url = "https://api.xhuoapi.ai/v1/flux/images"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "model": "doubao-seedream-4-0-250828",
    "prompt": "Keep the model pose and the liquid garment flowing shape unchanged. Change the clothing material from silver metal to completely transparent water (or glass). Through the liquid flow, the details of the model skin are visible. The light and shadow effect shifts from reflection to refraction.",
    "image": ["https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imageToimage.png"],
    "size": "2K",
    "watermark": False
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

{
    "success": true,
    "task_id": "c9aaffa2-b8ac-40ff-8468-43e77cb9ddde",
    "trace_id": "131a40c3-2eaf-44c9-af28-c9b408577286",
    "data": [
        {
            "prompt": "Keep the model pose and the liquid garment flowing shape unchanged. Change the clothing material from silver metal to completely transparent water (or glass). Through the liquid flow, the details of the model skin are visible. The light and shadow effect shifts from reflection to refraction.",
            "size": "2048x2048",
            "image_url": "https://platform.cdn.xhuoapi.ai/seedream/3e88db7e-4771-4f6a-adbd-5ae4590c5d59.jpg"
        }
    ]
}

​

Асинхронные обратные вызовы

{
  "task_id": "c9aaffa2-b8ac-40ff-8468-43e77cb9ddde"
}

{
    "success": true,
    "task_id": "c9aaffa2-b8ac-40ff-8468-43e77cb9ddde",
    "trace_id": "131a40c3-2eaf-44c9-af28-c9b408577286",
    "data": [
        {
            "prompt": "Keep the model pose and the liquid garment flowing shape unchanged. Change the clothing material from silver metal to completely transparent water (or glass). Through the liquid flow, the details of the model skin are visible. The light and shadow effect shifts from reflection to refraction.",
            "size": "2048x2048",
            "image_url": "https://platform.cdn.xhuoapi.ai/seedream/3e88db7e-4771-4f6a-adbd-5ae4590c5d59.jpg"
        }
    ]
}

​

Ошибки и их обработка

• 400 token_mismatched: ошибка запроса, возможно, неверные параметры.
• 400 api_not_implemented: функция не реализована.
• 401 invalid_token: неверный или отсутствующий токен авторизации.
• 429 too_many_requests: превышен лимит запросов.
• 500 api_error: внутренняя ошибка сервера.

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​

Итоги