MMashaGPT API
К обзору модели

API-документация

Подробное подключение Task API для Seedream 5.0 Pro Text-to-Image

API-документация

Эндпоинт

Базовый URLhttps://api.mashagpt.ru/v1
Эндпоинт
POST
/v1/tasks/seedream-v5-pro-text-to-image
Авторизация
x-api-key: YOUR_API_KEY
илиAuthorization: Bearer YOUR_API_KEY

Параметры запроса

ПараметрТипОписание
prompt*
stringText prompt describing the image to generate. Пример — A cinematic product photo with soft studio lighting.
aspectRatio
stringДопустимые значения: 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9. Output aspect ratio. По умолчанию — 1:1.
quality
stringДопустимые значения: basic, high. Output quality: basic (1K) or high (2K). По умолчанию — basic.
outputFormat
stringДопустимые значения: png, jpeg. Generated image format. По умолчанию — png.
nsfwChecker
booleanServer-managed NSFW policy. Request-body values are overridden: enabled by default, disabled only with a valid story_test query token. По умолчанию — true.

Пример запроса и ответа

Запрос
curl -X POST https://api.mashagpt.ru/v1/tasks/seedream-v5-pro-text-to-image \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "prompt": "A cinematic product photo with soft studio lighting",
  "aspectRatio": "1:1",
  "quality": "basic",
  "outputFormat": "png",
  "nsfwChecker": true
}'
Ответ
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "550e8400-e29b-41d4-a716-446655440000",
    "state": "queued"
  }
}

Асинхронная обработка

Модель работает асинхронно. После запроса вы получите taskId задачи для отслеживания статуса.

GET
/v1/tasks/{id}статус задачи
Проверка статуса задачи:
curl -X GET "https://api.mashagpt.ru/v1/tasks/{task_id}" \
  -H "x-api-key: YOUR_API_KEY"

Жизненный цикл задачи:

queued→processing→completed|failed