Примеры использования (cURL, Python, JavaScript)

cURL

Текстовый запрос (автовыбор модели)

curl -X POST https://d5daftde5irfpvduu5pm.wnq2w1o5.apigw.yandexcloud.net/api/chat \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Привет!"}]}'

Явное указание модели

curl -X POST .../api/chat \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek/deepseek-v4-flash","messages":[{"role":"user","content":"Напиши код сортировки"}]}'

Генерация изображения

curl -X POST .../api/chat \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Нарисуй закат"}]}'

Эмбеддинги

curl -X POST .../api/embeddings \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"input":"Привет, мир!"}'

Python

import requests

API_URL = "https://d5daftde5irfpvduu5pm.wnq2w1o5.apigw.yandexcloud.net/api"
HEADERS = {
    "Authorization": "Bearer ВАШ_API_КЛЮЧ",
    "Content-Type": "application/json"
}

# Текстовый запрос (автовыбор)
data = {"messages": [{"role": "user", "content": "Привет!"}]}
resp = requests.post(f"{API_URL}/chat", headers=HEADERS, json=data)
print(resp.json())

# Явное указание модели
data["model"] = "deepseek/deepseek-v4-flash"
resp = requests.post(f"{API_URL}/chat", headers=HEADERS, json=data)
print(resp.json())

# Генерация изображения
data_img = {"messages": [{"role": "user", "content": "Нарисуй закат"}]}
resp_img = requests.post(f"{API_URL}/chat", headers=HEADERS, json=data_img)
print(resp_img.json())  # ответ содержит "images"

# Эмбеддинги
emb_data = {"input": ["Привет", "Как дела?"]}
resp_emb = requests.post(f"{API_URL}/embeddings", headers=HEADERS, json=emb_data)
print(resp_emb.json())

JavaScript

const API_URL = "https://d5daftde5irfpvduu5pm.wnq2w1o5.apigw.yandexcloud.net/api";
const headers = {
  "Authorization": "Bearer ВАШ_API_КЛЮЧ",
  "Content-Type": "application/json"
};

// Текстовый запрос (автовыбор)
fetch(`${API_URL}/chat`, {
  method: "POST",
  headers,
  body: JSON.stringify({ messages: [{ role: "user", content: "Привет!" }] })
})
  .then(r => r.json())
  .then(console.log);

// Явное указание модели
fetch(`${API_URL}/chat`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    model: "deepseek/deepseek-v4-flash",
    messages: [{ role: "user", content: "Напиши код..." }]
  })
})
  .then(r => r.json())
  .then(console.log);

// Генерация изображения
fetch(`${API_URL}/chat`, {
  method: "POST",
  headers,
  body: JSON.stringify({ messages: [{ role: "user", content: "Нарисуй закат" }] })
})
  .then(r => r.json())
  .then(console.log);

// Эмбеддинги
fetch(`${API_URL}/embeddings`, {
  method: "POST",
  headers,
  body: JSON.stringify({ input: ["Привет", "Мир"] })
})
  .then(r => r.json())
  .then(console.log);

Обработка ошибок

API возвращает стандартные HTTP‑коды:

• 200 – успех.
• 400 – некорректный запрос (отсутствует messages и т.п.).
• 401 – неверный или отсутствующий API‑ключ.
• 403 – недостаточно токенов для операции (например, для генерации изображений).
• 429 – баланс пуст.
• 502 – все модели временно недоступны.

В теле ответа будет поле error с описанием проблемы.