API Документация

Интегрируйте AI модели в свои приложения через простой REST API

Обзор

External API предоставляет доступ к AI моделям через REST API с аутентификацией по API ключам.

Базовый URL

https://smmcode.com/api/v1/external
Войти для создания API ключа

Быстрый старт

  1. 1 Войдите и создайте API ключ
  2. 2 Используйте ключ в заголовке Authorization: Bearer YOUR_API_KEY
  3. 3 Отправьте запрос на /api/v1/external/chat/completions

Аутентификация

Все запросы требуют API ключ в заголовке Authorization:

Authorization: Bearer sk_live_your_api_key_here

Получение API ключа

API ключи создаются в личном кабинете пользователя в разделе "API Ключи".

Формат ключа

sk_live_[48 случайных символов]

Endpoints

POST
/chat/completions

Отправка сообщения и получение полного ответа (синхронно)

Пример запроса (cURL):

curl -X POST https://smmcode.com/api/v1/external/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-3.5-sonnet",
    "messages": [
      {"role": "user", "content": "Привет!"}
    ],
    "temperature": 0.7,
    "max_tokens": 2048
  }'

Параметры:

Параметр Тип Описание
model string ID модели (обязательно)
messages array Массив сообщений (обязательно)
temperature float 0-2, по умолчанию 0.7
max_tokens integer 1-8192, по умолчанию 2048
POST
/chat/stream

Потоковая отправка ответа через Server-Sent Events (SSE)

Параметры запроса такие же как для /chat/completions

GET
/models

Получение списка доступных моделей

Пример запроса:

curl https://smmcode.com/api/v1/external/models \
  -H "Authorization: Bearer YOUR_API_KEY"
GET
/balance

Получение текущего баланса пользователя

GET
/usage

Получение статистики использования API с фильтрацией и пагинацией

Коды ошибок

401
Unauthorized
API ключ не предоставлен или недействителен
402
Payment Required
Недостаточно средств на балансе (минимум 15₽)
422
Validation Error
Ошибка валидации входных данных
429
Rate Limit Exceeded
Превышен дневной лимит запросов или расходов
500
Internal Server Error
Внутренняя ошибка сервера

Примеры использования

Python

import requests

url = "https://smmcode.com/api/v1/external/chat/completions"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "model": "anthropic/claude-3.5-sonnet",
    "messages": [
        {"role": "user", "content": "Привет!"}
    ]
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

JavaScript (Node.js)

const axios = require('axios');

const url = 'https://smmcode.com/api/v1/external/chat/completions';
const headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
};
const data = {
    model: 'anthropic/claude-3.5-sonnet',
    messages: [
        { role: 'user', content: 'Привет!' }
    ]
};

axios.post(url, data, { headers })
    .then(response => console.log(response.data))
    .catch(error => console.error(error));

PHP

$url = 'https://smmcode.com/api/v1/external/chat/completions';
$apiKey = 'YOUR_API_KEY';

$data = [
    'model' => 'anthropic/claude-3.5-sonnet',
    'messages' => [
        ['role' => 'user', 'content' => 'Привет!']
    ]
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiKey,
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

Безопасность

Рекомендации

  • Храните API ключи в безопасности - никогда не публикуйте их в коде
  • Используйте переменные окружения для хранения ключей
  • Создавайте отдельные ключи для разных проектов
  • Регулярно ротируйте ключи для повышения безопасности
  • Мониторьте использование через статистику API

Что делать при компрометации ключа

  1. Немедленно деактивируйте ключ в личном кабинете
  2. Создайте новый ключ
  3. Обновите ключ во всех приложениях

Лимиты

  • Минимальный баланс: 15 рублей
  • Максимум сообщений в истории: 100
  • Максимум символов в сообщении: 100,000
  • Максимум токенов на запрос: зависит от модели (обычно 8192)
  • Дневные лимиты: настраиваются для каждого API ключа

Поддержка

При возникновении вопросов или проблем:

  • Проверьте документацию
  • Проверьте логи в личном кабинете
  • Свяжитесь с поддержкой через тикет-систему

Доступные модели

Gemini

Gemini 3 Flash Preview

google/gemini-3-flash-preview
Gemini

Gemini 3 Pro Preview

google/gemini-3-pro-preview
Open AI

GPT-5.1-Codex-Max

openai/gpt-5.1-codex-max
Open AI

GPT-5.2

openai/gpt-5.2
Open AI

GPT-5.2 Chat

openai/gpt-5.2-chat
Open AI

GPT-5.2 Pro

openai/gpt-5.2-pro
X AI

Grok 4.1 Fast

x-ai/grok-4.1-fast
Qwen

Qwen3 32B

qwen/qwen3-32b
Open AI

GPT OSS 120b

openai/gpt-oss-120b
Gemini

Gemini 2.5 (Flash Lite)

google/gemini-2.5-flash-lite
Llama

Llama 4 (Scout)

meta-llama/llama-4-scout
Llama

Llama 4 (Maverick)

meta-llama/llama-4-maverick
DeepSeek

DeepSeek V3.1 (Terminus)

deepseek/deepseek-v3.1-terminus
Qwen

Qwen3 235B (A22B)

qwen/qwen3-235b-a22b
Gemini

Gemini 2.5 (Pro)

google/gemini-2.5-pro
Open AI

GPT-5 (Nano)

openai/gpt-5-nano
Open AI

GPT-5 (Mini)

openai/gpt-5-mini
Claude

Claude Haiku 4.5

anthropic/claude-haiku-4.5
Open AI

GPT-5

openai/gpt-5
Claude

Claude Sonnet 3.7

anthropic/claude-3.7-sonnet
Claude

Claude Opus 4

anthropic/claude-opus-4
Claude

Claude Opus 4.1

anthropic/claude-opus-4.1
Claude

Claude Sonnet 4.5

anthropic/claude-sonnet-4.5
X AI

Grok 4

x-ai/grok-4
X AI

Grok 3 Mini (Beta)

x-ai/grok-3-mini-beta