Сторінки API моделей
API-інтеграція для Seedream 3.0
Використовуйте Seedream 3.0 через Rivya Public API v1 з ID моделі seedream-3-0, підтримуваними входами, параметрами, правилами Files API, кредитами й прикладами відповідей.
Доступно через APIТекстовий ввід готовийЗображення
ID моделі API
seedream-3-0
Входи
text
Files API
Не потрібно для мінімального запиту
Базові кредити
5
Можливість
Зображення
Білінг
FIXED
Ліміт промпта
5000 символів
Контракт запиту
Надсилайте ID моделі на верхньому рівні. Керування конкретної моделі належить у params.
| Ключ | Тип | Обов'язково | За замовчуванням | Опис |
|---|---|---|---|---|
| model | string | Так | seedream-3-0 | Використовуйте seedream-3-0 як ID моделі API. |
| prompt | string | Так | - | Максимум 5000 символів для цієї моделі. |
| params | object | Ні | - | Об'єкт параметрів конкретної моделі. Дозволені ключі дивіться в рядках нижче. |
| client_request_id | string | Ні | - | Необов'язковий клієнтський ID для трасування запитів у вашій системі. |
Параметри моделі
| Ключ | Тип | Обов'язково | За замовчуванням | Діапазон | Опції | Опис |
|---|---|---|---|---|---|---|
| image_size | select | Ні | square_hd | - | square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9 | Керує формою кадрування виводу. Square HD є поточним стандартним варіантом і добре працює для більшості загальних композицій. |
| guidance_scale | number | Ні | 2.5 | min 1 / max 10 / step 0.1 | - | Допустимі значення - від 1 до 10. Вищі значення зазвичай точніше слідують prompt, але можуть зробити результат жорсткішим. |
| seed | number | Ні | - | min 0 / max 2147483647 | - | Залиште порожнім, щоб щоразу отримувати новий випадковий результат. Повторне використання того самого цілого числа допомагає легше відтворити або тонко налаштувати попередній результат. Він лишається ближчим лише тоді, коли промпт та інші ключові налаштування теж подібні, і це не гарантує збіг 1:1. |
Мінімальний запит
{
"model": "seedream-3-0",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"image_size": "square_hd",
"guidance_scale": 2.5,
"seed": 0
}
}Відповідь створення
Ендпоінт створення повертає публічний ID задачі. Опитуйте ендпоінт статусу, доки задача не завершиться успішно або з помилкою.
{
"id": "task_seedream_3_0_example",
"status": "queued",
"model": "seedream-3-0",
"reserved_credits": 5,
"final_credits": 0,
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:00:00.000Z",
"result": null,
"error": null
}Поширені помилки
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Ендпоінт створення повертає публічний ID задачі. Опитуйте ендпоінт статусу, доки задача не завершиться успішно або з помилкою.