Seed3D v1

Справочник Seed3D v1 API

Генерируйте GLB 3D-ассеты из одного URL изображения. Публичный API принимает пользовательский ключ, создает асинхронную задачу и возвращает статус и URL результата.

API v1https://seed3d-ai.org/v180 credits

Быстрый старт

curl -X POST 'https://seed3d-ai.org/v1/generate' \
  -H 'Authorization: Bearer YOUR_ZA_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "image": "https://example.com/product.png",
    "prompt": "clean topology, neutral studio lighting",
    "subdivision_level": "medium"
  }'

Аутентификация

Передавайте пользовательский API-ключ в заголовке Authorization для каждого запроса.

Создайте или скопируйте ключ в панели: API-ключи

Authorization: Bearer YOUR_ZA_API_KEY

Цены

Генерация image-to-3D

Кредиты списываются после принятия задачи. Ошибки отправки провайдеру возмещаются backend.

80 credits

API эндпоинты

Отправьте URL изображения и опциональные подсказки. Ответ сразу возвращает task_id.

`image` required string	Публичный HTTP или HTTPS URL изображения. Рекомендуются JPG, PNG и WebP.
`prompt` optional string	Опциональная подсказка о поверхности, материале, геометрии или назначении. До 2000 символов.
`subdivision_level` optional string	Подсказка детализации mesh. Значения: low, medium, high или 0, 1, 2.default: provider default
`public` optional boolean	Можно ли считать результат публичным для последующих функций.default: false
`callback_url` optional string	Опциональный публичный webhook URL. Localhost отклоняется.

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

{
  "image": "https://example.com/product.png",
  "prompt": "clean topology, neutral studio lighting",
  "subdivision_level": "medium",
  "public": false,
  "callback_url": "https://example.com/webhooks/seed3d"
}

Ответы

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n105abc123s3d",
    "status": "IN_PROGRESS",
    "consumed_credits": 80
  }
}

Опрашивайте до SUCCESS или FAILED. Успешная задача возвращает response как массив URL.

task_id

required string

ID задачи из POST /v1/generate.

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

curl -X GET 'https://seed3d-ai.org/v1/status?task_id=n105abc123s3d' \
  -H 'Authorization: Bearer YOUR_ZA_API_KEY'

Ответы

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n105abc123s3d",
    "status": "SUCCESS",
    "consumed_credits": 80,
    "request": {
      "image": "https://example.com/product.png",
      "prompt": "clean topology, neutral studio lighting",
      "subdivision_level": "medium"
    },
    "response": [
      "https://cdn.example.com/seed3d-output.glb"
    ],
    "error_message": null
  }
}

Запрашивайте недавние задачи, созданные API-ключом из Authorization.

`page` optional number	Номер страницы.default: 1
`limit` optional number	Количество элементов на странице, ограничивается backend.default: 20
`task_id` optional string	Опциональный фильтр по точному ID задачи.

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

curl -X GET 'https://seed3d-ai.org/v1/list?page=1&limit=20' \
  -H 'Authorization: Bearer YOUR_ZA_API_KEY'

Инструменты панели

Используйте панель для ключей и логов во время интеграции.

Открыть API-ключи Открыть API-логи

Коды ошибок

HTTP	Причина
400	Отсутствует или некорректен параметр запроса.
401	Bearer token отсутствует или недействителен.
402	Недостаточно кредитов на аккаунте API-ключа.
403	Запрошенный API key не совпадает с bearer token.
404	ID задачи не найден.
405	Метод HTTP не разрешен для маршрута.
500	Ошибка сервера или провайдера. Повторите позже или обратитесь в поддержку.