API + MCP

Ключ привязан к вашему аккаунту и балансу. Любая генерация через REST API или MCP списывает те же кредиты, что и генерация в интерфейсе. Если кредитов недостаточно, API вернёт ошибку.

Ваш ключ

Загружаю ключ...

REST API

Базовый URL: https://www.desentraai.ru. Во всех запросах передавайте заголовок Authorization: Bearer YOUR_KEY.

curl --request POST 'https://www.desentraai.ru/api/video/generate' \
  --header 'Authorization: Bearer YOUR_DE...KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "provider": "sidence",
    "prompt": "Кинематографичный кадр: город будущего на закате, плавный пролёт камеры",
    "sidenceModel": "bytedance/seedance-2",
    "mode": "TEXT_2_VIDEO",
    "duration": "8",
    "resolution": "720p",
    "aspectRatio": "16:9",
    "generateAudio": false
  }'

curl 'https://www.desentraai.ru/api/video/status?provider=sidence&taskId=TASK_ID&quality=1080p' \
  --header 'Authorization: Bearer YOUR_DE...KEY'

curl --request POST 'https://www.desentraai.ru/api/market/generate' \
  --header 'Authorization: Bearer YOUR_DE...KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "modelId": "claude",
    "variantId": "claude-sonnet-46",
    "prompt": "Составь короткий план запуска рекламной кампании.",
    "settings": {
      "temperature": 0.7,
      "maxTokens": 2048
    }
  }'

MCP

MCP endpoint: https://www.desentraai.ru/api/mcp. Сервер даёт инструменты для capabilities, workspace chats, upload reference assets, typed generations, polling, history и refreshable download links. Генерации идут через тот же баланс и сохраняются в истории сайта.

{
  "mcpServers": {
    "desentra": {
      "url": "https://www.desentraai.ru/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_DE...KEY"
      }
    }
  }
}

Подключи Desentra AI через MCP.
1. Используй MCP endpoint: https://www.desentraai.ru/api/mcp
2. Авторизация: Authorization: Bearer <мой API ключ>
3. Сначала вызови desentra_capabilities и прочитай доступные модели, размеры, форматы и endpoints.
4. Создай или используй workspace chat через desentra_create_chat. Если chatKey не передан, используй стабильный fox:<workspace>:api-mcp chat.
5. Загружай референсы через desentra_upload_asset_from_url или desentra_upload_asset_base64.
6. Генерируй typed tools: desentra_generate_veo_video, desentra_generate_seedance_video, desentra_generate_kling_video, desentra_generate_nanobanana_image, desentra_generate_suno_audio, desentra_generate_elevenlabs_audio, desentra_generate_market или desentra_generate_marketforge.
7. Проверяй результат через desentra_poll, затем читай историю через desentra_list_generations и обновляй ссылки через desentra_get_artifact_download_url.
8. Если API вернул ошибку о кредитах, покажи пользователю, что баланс нужно пополнить.

curl --request POST 'https://www.desentraai.ru/api/mcp' \
  --header 'Authorization: Bearer YOUR_DE...KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "desentra_upload_asset_from_url",
      "arguments": {
        "workspace": "sidence",
        "url": "https://example.com/reference-photo.jpg",
        "kind": "image"
      }
    }
  }'

curl --request POST 'https://www.desentraai.ru/api/mcp' \
  --header 'Authorization: Bearer YOUR_DE...KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "desentra_generate_seedance_video",
      "arguments": {
        "workspace": "sidence",
        "referenceArtifactIds": ["ARTIFACT_ID_FROM_UPLOAD"],
        "prompt": "Сделай из референса кинематографичное видео на 8 секунд.",
        "sidenceModel": "bytedance/seedance-2",
        "mode": "IMAGE_2_VIDEO",
        "sidenceDuration": "8",
        "sidenceAspectRatio": "16:9",
        "sidenceResolution": "720p"
      }
    }
  }'

curl --request POST 'https://www.desentraai.ru/api/mcp' \
  --header 'Authorization: Bearer YOUR_DE...KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "desentra_poll",
      "arguments": {
        "workspace": "sidence",
        "modality": "video",
        "query": {
          "provider": "sidence",
          "taskId": "TASK_ID_FROM_GENERATE",
          "quality": "1080p"
        },
        "intervalMs": 5000,
        "timeoutMs": 600000
      }
    }
  }'

curl --request POST 'https://www.desentraai.ru/api/mcp' \
  --header 'Authorization: Bearer YOUR_DE...KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": {
      "name": "desentra_list_generations",
      "arguments": {
        "workspace": "sidence",
        "providerId": "sidence",
        "modality": "video",
        "limit": 10
      }
    }
  }'