Claude API из России, без VPN

# pip install anthropic
import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["APRIUM_API_KEY"],  # ключ: ai.aprium.ru/#keys
    base_url="https://api.aprium.ru",
)

Перед запуском: export APRIUM_API_KEY="ваш_ключ". Ключ: ai.aprium.ru/#keys → «Создать ключ».

// npm install @anthropic-ai/sdk
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  apiKey: process.env.APRIUM_API_KEY, // ключ: ai.aprium.ru/#keys
  baseURL: "https://api.aprium.ru",
});

Перед запуском: export APRIUM_API_KEY="ваш_ключ".

export APRIUM_API_KEY="ваш_ключ"

# В каждом запросе: адрес api.aprium.ru и два заголовка
curl https://api.aprium.ru/v1/messages \
  -H "x-api-key: $APRIUM_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5-5", "max_tokens": 64,
       "messages": [{"role": "user", "content": "Проверка связи"}]}'

Если ключ верный, придёт ответ модели. Ошибка 401 значит, что ключ не указан или указан неверно.

message = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=2048,
    messages=[
        {"role": "user", "content": "Составь план статьи про налоговый вычет за обучение"},
    ],
)
print(message.content.at(-1).text)

const message = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 2048,
  messages: [
    { role: "user", content: "Составь план статьи про налоговый вычет за обучение" },
  ],
});
console.log(message.content.at(-1).text);

curl https://api.aprium.ru/v1/messages \
  -H "x-api-key: $APRIUM_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 2048,
    "messages": [
      {"role": "user", "content": "Составь план статьи про налоговый вычет за обучение"}
    ]
  }'

print(message.content.at(-1).text)    # текст ответа
print(message.stop_reason)        # end_turn — готово, max_tokens — упёрся в лимит
print(message.usage)              # input_tokens и output_tokens: по ним считается цена

# Ответ по частям, как в чате
with client.messages.stream(
    model="claude-sonnet-5-5",
    max_tokens=2048,
    messages=[{"role": "user", "content": "Расскажи про осень"}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

console.log(message.content.at(-1).text); // текст ответа
console.log(message.stop_reason);     // end_turn — готово, max_tokens — упёрся в лимит
console.log(message.usage);           // input_tokens и output_tokens: по ним считается цена

// Ответ по частям, как в чате
const stream = client.messages.stream({
  model: "claude-sonnet-5-5",
  max_tokens: 2048,
  messages: [{ role: "user", content: "Расскажи про осень" }],
});
stream.on("text", (text) => process.stdout.write(text));
await stream.finalMessage();

# Только текст ответа (нужен jq)
curl -s https://api.aprium.ru/v1/messages \
  -H "x-api-key: $APRIUM_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5-5", "max_tokens": 1024,
       "messages": [{"role": "user", "content": "Привет!"}]}' \
  | jq -r '.content[-1].text'

# По частям: "stream": true и -N, чтобы curl не копил вывод
curl -N https://api.aprium.ru/v1/messages \
  -H "x-api-key: $APRIUM_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5-5", "max_tokens": 1024, "stream": true,
       "messages": [{"role": "user", "content": "Расскажи про осень"}]}'

{
  "id": "msg_01...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5-5",
  "content": [
    { "type": "text", "text": "План статьи: 1. Кто может получить вычет..." }
  ],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 24, "output_tokens": 412 }
}

Формат совпадает с Anthropic Messages API.

message = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=4096,                 # предел длины ответа
    system="Отвечай по делу, без вступлений.",
    output_config={"effort": "medium"},  # low, medium, high, xhigh, max
    stop_sequences=["---"],          # остановиться на этой строке
    messages=[{"role": "user", "content": "Сократи текст до трёх пунктов: ..."}],
)

По умолчанию effort = high. temperature и top_p не поддерживаются, не указывайте их.

const message = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 4096,                  // предел длины ответа
  system: "Отвечай по делу, без вступлений.",
  output_config: { effort: "medium" },  // low, medium, high, xhigh, max
  stop_sequences: ["---"],           // остановиться на этой строке
  messages: [{ role: "user", content: "Сократи текст до трёх пунктов: ..." }],
});

По умолчанию effort = high. temperature и top_p не поддерживаются, не указывайте их.

curl https://api.aprium.ru/v1/messages \
  -H "x-api-key: $APRIUM_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 4096,
    "system": "Отвечай по делу, без вступлений.",
    "output_config": {"effort": "medium"},
    "stop_sequences": ["---"],
    "messages": [{"role": "user", "content": "Сократи текст до трёх пунктов: ..."}]
  }'

По умолчанию effort = high. temperature и top_p не поддерживаются, не указывайте их.

import base64

with open("dogovor.pdf", "rb") as f:
    pdf = base64.standard_b64encode(f.read()).decode()

message = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=2048,
    messages=[{
        "role": "user",
        "content": [
            {"type": "document",
             "source": {"type": "base64", "media_type": "application/pdf", "data": pdf}},
            {"type": "text", "text": "Выпиши сроки и штрафы из договора"},
        ],
    }],
)

Картинка передаётся так же: type image и media_type image/png или image/jpeg.

import { readFileSync } from "node:fs";

const pdf = readFileSync("dogovor.pdf").toString("base64");

const message = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 2048,
  messages: [{
    role: "user",
    content: [
      { type: "document",
        source: { type: "base64", media_type: "application/pdf", data: pdf } },
      { type: "text", text: "Выпиши сроки и штрафы из договора" },
    ],
  }],
});

Картинка передаётся так же: type image и media_type image/png или image/jpeg.

PDF=$(base64 < dogovor.pdf | tr -d '\n')

curl https://api.aprium.ru/v1/messages \
  -H "x-api-key: $APRIUM_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 2048,
    "messages": [{"role": "user", "content": [
      {"type": "document",
       "source": {"type": "base64", "media_type": "application/pdf", "data": "'"$PDF"'"}},
      {"type": "text", "text": "Выпиши сроки и штрафы из договора"}
    ]}]
  }'

Для больших файлов сохраните тело запроса в request.json и отправьте через -d @request.json.