API Reference

Anthropic Messages API

Тестируйте BetterToken Anthropic-compatible Messages API: x-api-key, anthropic-version и POST /v1/messages.

POST /v1/messages

Используйте этот endpoint для Claude Code, Anthropic SDK и приложений, работающих с Anthropic Messages API.

Тест в Playground

В Playground справа вставьте свой API Key в поле x-api-key, оставьте anthropic-version равным 2023-06-01, укажите модель из model plaza и отправьте запрос.

Связанные endpoint

POST/v1/messages

Авторизации

x-api-keystringheaderобязательно

Передавайте API Key BetterToken в header x-api-key для Anthropic-compatible запросов.

Заголовки

anthropic-versionstringпо умолчанию: 2023-06-01обязательно

Заголовок версии Anthropic API.

Пример:"2023-06-01"

Тело application/json

modelstringобязательно

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

Пример:"YOUR_MODEL_ID"

max_tokensintegerпо умолчанию: 1024обязательно

Максимальное число токенов в одном ответе.

Требуемый диапазон: x >= 1

Пример:1024

messagesobject[]обязательно

Массив сообщений в формате Anthropic. Каждый элемент должен содержать role и content.

Minimum array length: 1

Show child attributes

messages[].rolestringобязательно

Пример:"user"

messages[].contentstringобязательно

Пример:"Привет"

Ответ

200Ответ Anthropic Messages API от выбранной модели.

Ответ Anthropic-compatible Messages API. Поля зависят от выбранной модели и параметров запроса.

Пример

{}

400Неверный формат запроса, отсутствующие параметры, ошибка разбора JSON или multipart, либо неверный формат размера.

errorobject

Show child attributes

error.messagestring

Пример:"invalid request"

error.typestring

Пример:"invalid_request_error"

error.codestring

Пример:"invalid_request"

messagestring

Пример:"insufficient quota"

Пример

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

401API Key отсутствует или недействителен.

errorobject

Show child attributes

error.messagestring

Пример:"invalid request"

error.typestring

Пример:"invalid_request_error"

error.codestring

Пример:"invalid_request"

messagestring

Пример:"insufficient quota"

Пример

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

402Недостаточно квоты или баланса.

errorobject

Show child attributes

error.messagestring

Пример:"invalid request"

error.typestring

Пример:"invalid_request_error"

error.codestring

Пример:"invalid_request"

messagestring

Пример:"insufficient quota"

Пример

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

429Сработал rate limit, лимит параллельных запросов или upstream временно перегружен.

errorobject

Show child attributes

error.messagestring

Пример:"invalid request"

error.typestring

Пример:"invalid_request_error"

error.codestring

Пример:"invalid_request"

messagestring

Пример:"insufficient quota"

Пример

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

500Ошибка gateway или upstream-сервиса.

errorobject

Show child attributes

error.messagestring

Пример:"invalid request"

error.typestring

Пример:"invalid_request_error"

error.codestring

Пример:"invalid_request"

messagestring

Пример:"insufficient quota"

Пример

{
  "error": {
    "message": "invalid request",
    "type": "invalid_request_error",
    "code": "invalid_request"
  },
  "message": "insufficient quota"
}

curl 'https://bettertoken.ai/v1/messages' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'anthropic-version: 2023-06-01' \ -H 'content-type: application/json' \ --data '{ "model": "YOUR_MODEL_ID", "max_tokens": 1024, "messages": [{"role": "user", "content": "Привет"}] }'

import requests url = "https://bettertoken.ai/v1/messages" payload = { "model": "YOUR_MODEL_ID", "max_tokens": 1024, "messages": [ { "role": "user", "content": "Привет" } ] } headers = { "anthropic-version": "<anthropic-version>", "x-api-key": "<api-key>", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.text)

const options = { method: 'POST', headers: { 'anthropic-version': '<anthropic-version>', 'x-api-key': '<api-key>', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'YOUR_MODEL_ID', max_tokens: 1024, messages: [{role: 'user', content: 'Привет'}] }) }; fetch('https://bettertoken.ai/v1/messages', options) .then(res => res.json()) .then(res => console.log(res)) .catch(err => console.error(err));

<?php $curl = curl_init(); curl_setopt_array($curl, [ CURLOPT_URL => "https://bettertoken.ai/v1/messages", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_POSTFIELDS => json_encode([ 'model' => 'YOUR_MODEL_ID', 'max_tokens' => 1024, 'messages' => [ [ 'role' => 'user', 'content' => 'Привет' ] ] ]), CURLOPT_HTTPHEADER => [ "Content-Type: application/json", "anthropic-version: <anthropic-version>", "x-api-key: <api-key>" ], ]); $response = curl_exec($curl); $err = curl_error($curl); curl_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; }

package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://bettertoken.ai/v1/messages" payload := strings.NewReader("{\n \"model\": \"YOUR_MODEL_ID\",\n \"max_tokens\": 1024,\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Привет\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("anthropic-version", "<anthropic-version>") req.Header.Add("x-api-key", "<api-key>") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(string(body)) }

HttpResponse<String> response = Unirest.post("https://bettertoken.ai/v1/messages") .header("anthropic-version", "<anthropic-version>") .header("x-api-key", "<api-key>") .header("Content-Type", "application/json") .body("{\n \"model\": \"YOUR_MODEL_ID\",\n \"max_tokens\": 1024,\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Привет\"\n }\n ]\n}") .asString();

require 'uri' require 'net/http' url = URI("https://bettertoken.ai/v1/messages") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["anthropic-version"] = '<anthropic-version>' request["x-api-key"] = '<api-key>' request["Content-Type"] = 'application/json' request.body = "{\n \"model\": \"YOUR_MODEL_ID\",\n \"max_tokens\": 1024,\n \"messages\": [\n {\n \"role\": \"user\",\n \"content\": \"Привет\"\n }\n ]\n}" response = http.request(request) puts response.read_body