API для разработчиков
OpenAI-совместимый API для доступа к GPT-4o, Claude, Gemini, Mistral и генерации изображений — без VPN, без санкций, из России. Работает с openai SDK простой сменой base_url.
Base URL
aineron.ru/api/v1
Аутентификация
Bearer ak_...
Формат ошибок
OpenAI-совместимый
Биллинг
Звёзды / 1 000 токенов
Быстрый старт
- 1Создайте API-ключ в личном кабинете — раздел API-ключи. Ключ показывается один раз, сохраните его сразу.
- 2Укажите наш base_url вместо
api.openai.comв вашем SDK или HTTP-клиенте. - 3Пополните баланс звёзд и начните запросы — списание по токенам автоматически.
curl https://aineron.ru/api/v1/chat/completions \
-H "Authorization: Bearer ak_ВАШ_КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o",
"messages": [
{"role": "user", "content": "Привет! Напиши Hello World на Python"}
]
}'Anthropic SDK (Claude-модели)
Если вы используете официальный Anthropic SDK, достаточно указать наш base_url — API полностью совместим с POST /api/v1/messages.
import anthropic
client = anthropic.Anthropic(
base_url="https://aineron.ru/api/v1",
api_key="ak_ВАШ_КЛЮЧ",
)
message = client.messages.create(
model="claude-3-5-sonnet-20241022",
max_tokens=1024,
messages=[
{"role": "user", "content": "Объясни теорему Пифагора"}
]
)
print(message.content[0].text)Генерация изображений и видео
Доступ к Flux, SDXL, Wan, Kling и другим медиа-моделям через стандартный OpenAI Images API.
curl https://aineron.ru/api/v1/images/generations \
-H "Authorization: Bearer ak_ВАШ_КЛЮЧ" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-1-schnell",
"prompt": "Горный пейзаж на закате, фотореализм, 8K",
"n": 1,
"size": "1024x1024"
}'Список эндпоинтов
| Метод | Путь | Описание |
|---|---|---|
| POST | /api/v1/chat/completions | Chat completions (OpenAI-совместимый, stream) |
| POST | /api/v1/messages | Messages API (Anthropic-совместимый) |
| GET | /api/v1/models | Список доступных моделей |
| POST | /api/v1/images/generations | Генерация изображений и видео |
| GET | /api/v1/keys/ | Список API-ключей |
| POST | /api/v1/keys/ | Создать API-ключ |
| DELETE | /api/v1/keys/{id}/ | Удалить API-ключ |
| GET | /api/v1/schema/ | OpenAPI схема (YAML/JSON) |
| GET | /api/v1/docs/ | Swagger UI |
Коды ошибок
Все ошибки возвращаются в OpenAI-совместимом формате:
{
"error": {
"message": "Недостаточно звёзд для выполнения запроса",
"type": "insufficient_quota",
"code": "insufficient_quota"
}
}| HTTP | type | Причина |
|---|---|---|
| 401 | authentication_error | Неверный или отсутствующий API-ключ |
| 402 | insufficient_quota | Недостаточно звёзд на балансе |
| 403 | permission_error | Нет доступа к ресурсу |
| 429 | rate_limit_exceeded | Превышен лимит запросов (120/мин) |
| 400 | invalid_request_error | Неверные параметры запроса |