Руководство разработчика

curl https://api.vozmiapi.ru/v1/chat/completions \
  -H "Authorization: Bearer sk-am-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o-mini",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://api.vozmiapi.ru/v1",
    api_key="sk-am-...",
)

resp = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    messages=[{"role": "user", "content": "Привет!"}],
)
print(resp.choices[0].message.content)

from openai import OpenAI

client = OpenAI(
    base_url="https://api.vozmiapi.ru/v1",   # ← единственное изменение
    api_key="sk-am-...",             # ← и ключ
)

resp = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    messages=[
        {"role": "system", "content": "Ты — лаконичный ассистент."},
        {"role": "user", "content": "Объясни smart-blend одним предложением."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://api.vozmiapi.ru/v1', // ← единственное изменение
  apiKey: 'sk-am-...',           // ← и ключ
});

const resp = await client.chat.completions.create({
  model: 'openai/gpt-4o-mini',
  messages: [{ role: 'user', content: 'Привет!' }],
});
console.log(resp.choices[0].message.content);

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.vozmiapi.ru/api",   # SDK добавит /v1/messages
    api_key="sk-am-...",
)

msg = client.messages.create(
    model="anthropic/claude-3-5-sonnet",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Привет!"}],
)
print(msg.content[0].text)

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  baseURL: 'https://api.vozmiapi.ru/api', // SDK добавит /v1/messages
  apiKey: 'sk-am-...',
});

const msg = await client.messages.create({
  model: 'anthropic/claude-3-5-sonnet',
  max_tokens: 1024,
  messages: [{ role: 'user', content: 'Привет!' }],
});
console.log(msg.content[0].text);

curl -N https://api.vozmiapi.ru/v1/chat/completions \
  -H "Authorization: Bearer sk-am-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o-mini",
    "stream": true,
    "messages": [{"role": "user", "content": "Считай до 5"}]
  }'

stream = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    messages=[{"role": "user", "content": "Напиши хокку про API"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

curl https://api.vozmiapi.ru/v1/chat/completions \
  -H "Authorization: Bearer sk-am-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [{"role": "user", "content": "Погода в Бишкеке?"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Текущая погода по городу",
        "parameters": {
          "type": "object",
          "properties": { "city": { "type": "string" } },
          "required": ["city"]
        }
      }
    }],
    "tool_choice": "auto"
  }'

resp = client.chat.completions.create(
    model="openai/gpt-4o",
    messages=messages,
    tools=tools,
)
call = resp.choices[0].message.tool_calls[0]
# call.function.name == "get_weather"
# call.function.arguments == '{"city": "Бишкек"}'  (JSON-строка)

result = get_weather(**json.loads(call.function.arguments))

# Второй заход: возвращаем результат тем же tool_call_id
messages += [
    resp.choices[0].message,
    {"role": "tool", "tool_call_id": call.id, "content": json.dumps(result)},
]
final = client.chat.completions.create(model="openai/gpt-4o", messages=messages)
print(final.choices[0].message.content)

curl https://api.vozmiapi.ru/v1/chat/completions \
  -H "Authorization: Bearer sk-am-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [{
      "role": "user",
      "content": [
        { "type": "text", "text": "Что на картинке?" },
        { "type": "image_url",
          "image_url": { "url": "https://example.com/cat.jpg" } }
      ]
    }]
  }'

import base64

with open("photo.jpg", "rb") as f:
    b64 = base64.b64encode(f.read()).decode()

resp = client.chat.completions.create(
    model="openai/gpt-4o",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "Опиши изображение"},
            {"type": "image_url",
             "image_url": {"url": f"data:image/jpeg;base64,{b64}"}},
        ],
    }],
)
print(resp.choices[0].message.content)

resp = client.embeddings.create(
    model="openai/text-embedding-3-small",
    input=["первый текст", "второй текст"],
)
vectors = [d.embedding for d in resp.data]

curl https://api.vozmiapi.ru/v1/chat/completions \
  -H "Authorization: Bearer sk-am-..." \
  -H "X-AiMost-Blend: off" \
  -H "Content-Type: application/json" \
  -d '{ "model": "openai/gpt-4o", "messages": [...] }'

curl -X PATCH https://api.vozmiapi.ru/v1/auth/preferences \
  -H "Authorization: Bearer <JWT>" \
  -H "Content-Type: application/json" \
  -d '{ "blend_enabled": true, "blend_aggressiveness": "medium" }'

{
  "error": {
    "code": 402,
    "message": "insufficient_balance",
    "metadata": { "balance_kop": "0" }
  }
}

{ "error": { "code": 429, "message": "too_many_attempts",
    "metadata": { "retry_after_sec": 540 } } }

import crypto from 'crypto';

function verify(rawBody, signatureHeader, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody) // именно СЫРОЕ тело, до JSON.parse
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(expected),
    Buffer.from(signatureHeader),
  );
}