APIGrid
Получить ключ

Методы API

Все методы с параметрами и примерами. Каждый запрос — с ключом в заголовке Authorization: Bearer …, ошибки — в едином формате.

Создать задачу

POST/v1/tasks

Запускает генерацию и сразу списывает её цену. Отвечает 202 с объектом задачи в статусе queued.

Тело запроса
modelstringобязательный
ID модели, например kling-3.0. Список — Модели и параметры.
inputobjectобязательный
Параметры модели: промпт, длительность, разрешение и т. д. У каждой модели свои — см. её страницу.
webhook_urlstring
Адрес https://, на который придёт результат. См. Вебхуки.
Заголовки
Idempotency-Keystring
До 200 символов. Повтор с тем же ключом вернёт ту же задачу без второго списания. См. Повтор без дублей.
curl -X POST https://api.apigrid.cloud/v1/tasks \
  -H "Authorization: Bearer $APIGRID_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0",
    "input": {
      "prompt": "Котёнок играет с клубком на солнечном подоконнике",
      "duration": 5
    }
  }'
Ответ 202
{
  "id": "7e70388cf461f88d7149b1077e4ad098",
  "object": "task",
  "model": "kling-3.0",
  "status": "queued",
  "output": null,
  "error": null,
  "price": {
    "amount": "29.400000",
    "currency": "RUB",
    "refunded": false
  },
  "created_at": "2026-10-15T09:12:04.512Z",
  "started_at": "2026-10-15T09:12:04.880Z",
  "completed_at": null
}

Получить задачу

GET/v1/tasks/{id}

Возвращает текущее состояние задачи. Поля объекта — в разделе Объект задачи.

curl https://api.apigrid.cloud/v1/tasks/7e70388cf461f88d7149b1077e4ad098 \
  -H "Authorization: Bearer $APIGRID_KEY"
Ответ 200
{
  "id": "7e70388cf461f88d7149b1077e4ad098",
  "object": "task",
  "model": "kling-3.0",
  "status": "completed",
  "output": {
    "urls": [
      "https://…/video.mp4"
    ],
    "files": [
      {
        "url": "https://…/video.mp4",
        "kind": "video"
      }
    ]
  },
  "error": null,
  "price": {
    "amount": "29.400000",
    "currency": "RUB",
    "refunded": false
  },
  "created_at": "2026-10-15T09:12:04.512Z",
  "started_at": "2026-10-15T09:12:04.880Z",
  "completed_at": "2026-10-15T09:14:47.203Z"
}

Список задач

GET/v1/tasks

Задачи аккаунта на генерацию медиа, новые сверху.

Параметры строки запроса
limitintegerпо умолчанию 20
Сколько задач вернуть, от 1 до 100.
beforestring
Вернуть задачи, созданные раньше этого времени (ISO 8601). Для следующей страницы — created_at последней задачи.
curl https://api.apigrid.cloud/v1/tasks?limit=2 \
  -H "Authorization: Bearer $APIGRID_KEY"
Ответ 200
{
  "object": "list",
  "data": [
    {
      "id": "7e70388cf461f88d7149b1077e4ad098",
      "object": "task",
      "model": "kling-3.0",
      "status": "queued",
      "output": null,
      "error": null,
      "price": {
        "amount": "29.400000",
        "currency": "RUB",
        "refunded": false
      },
      "created_at": "2026-10-15T09:12:04.512Z",
      "started_at": "2026-10-15T09:12:04.880Z",
      "completed_at": null
    },
    {
      "id": "…",
      "object": "task",
      "…": "…"
    }
  ],
  "has_more": true
}

Список моделей

GET/v1/models

Все доступные модели: медиа — со схемой параметров input_schema (JSON Schema), текстовые — с размером контекста и протоколами.

Параметры строки запроса
categorystring
Только одна категория: video, image, audio или llm.
curl https://api.apigrid.cloud/v1/models?category=image \
  -H "Authorization: Bearer $APIGRID_KEY"
Ответ 200
{
  "object": "list",
  "data": [
    {
      "id": "nano-banana-2",
      "object": "model",
      "name": "Nano Banana 2",
      "vendor": "Google",
      "category": "image",
      "description": "Nano Banana 2: генерация и редактирование, до 14 референсов, 1K–4K.",
      "billing_unit": "per_image",
      "enabled": true,
      "input_schema": {
        "type": "object",
        "properties": {
          "prompt": {
            "type": "string"
          },
          "…": "…"
        },
        "required": [
          "prompt"
        ]
      },
      "available": true
    }
  ]
}

available — работает ли модель прямо сейчас: false, если последние запросы клиентов к ней подряд завершаются ошибкой модели. Если к модели давно не обращались, она считается работающей. История и uptime за 90 дней — на странице Статус моделей.

Если отправить запрос с заголовком anthropic-version, ответ придёт в формате Anthropic и только с текстовыми моделями — так список получает Claude Code.

Модель

GET/v1/models/{id}

Одна модель в том же формате, что и в списке. Удобно, чтобы получить актуальную схему параметров.

curl https://api.apigrid.cloud/v1/models/kling-3.0 \
  -H "Authorization: Bearer $APIGRID_KEY"

Цена задачи

POST/v1/models/{id}/quote

Считает цену задачи с этими параметрами. Ничего не создаёт и не списывает.

Тело запроса
inputobjectобязательный
Те же параметры, что для создания задачи.
curl -X POST https://api.apigrid.cloud/v1/models/kling-3.0/quote \
  -H "Authorization: Bearer $APIGRID_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "prompt": "Котёнок играет с клубком",
      "duration": 10,
      "mode": "pro"
    }
  }'
Ответ 200
{
  "model": "kling-3.0",
  "price": {
    "amount": "75.60",
    "currency": "RUB"
  }
}

Баланс

GET/v1/balance

Баланс аккаунта и сумма, зарезервированная под идущие запросы к текстовым моделям. Подробнее — Цены и баланс.

curl https://api.apigrid.cloud/v1/balance \
  -H "Authorization: Bearer $APIGRID_KEY"
Ответ 200
{
  "balance": "3986.330000",
  "held": "0.000000",
  "currency": "RUB"
}

Текстовые модели

Эти методы повторяют API OpenAI и Anthropic один в один — параметры и формат ответа смотрите в их документации. Особенности и примеры — в разделе Текстовые модели.

Chat Completions

POST/v1/chat/completions

Anthropic Messages

POST/v1/messages
POST/v1/messages/count_tokens

Responses

POST/v1/responses
Ключ
В Authorization: Bearer … или x-api-key.
Поток
"stream": true — Server-Sent Events в формате протокола.
Оплата
По токенам из поля usage; резерв под max_tokens на время запроса.