Быстрый старт
Чтобы начать использовать LyDian API, сначала вам понадобится ключ API. Вы можете создать свой ключ API в панели управления и сразу же начать его использовать.
Аутентификация
Все запросы API требуют ключа API в заголовке Authorization. Отправляйте свой ключ API как Bearer-токен.
Заголовок HTTP
Authorization: Bearer YOUR_API_KEY
Базовый URL
Базовый URL для всех конечных точек API. В продакшен-среде всегда используйте HTTPS.
https://api.ailydian.com/v1
Завершение чата
Основная конечная точка для общения с моделями LyDian AI. Потоковый (streaming) и непотоковый режимы. Используйте потоковый режим для ответов в реальном времени.
/chat/completions
Задавайте вопросы моделям ИИ через конечную точку завершения чата, пишите код, создавайте контент и многое другое.
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
modelОбязательный
|
string | Идентификатор модели (например: "lydian-turbo", "lydian-pro") |
messagesОбязательный
|
array | Массив сообщений чата (role, content) |
temperatureНеобязательный
|
number | От 0 до 2 (по умолчанию: 0.7) - Уровень креативности |
max_tokensНеобязательный
|
integer | Максимальное количество токенов (по умолчанию: 2000) |
streamНеобязательный
|
boolean | Потоковый режим (по умолчанию: false) |
Пример запроса
const response =
await
fetch('https://api.ailydian.com/v1/chat/completions', { method:
'POST', headers:
{ 'Authorization':
'Bearer sk-lydian-...',
'Content-Type':
'application/json'
},
body: JSON.stringify({ model:
'lydian-turbo',
messages: [ { role:
'user', content:
'Merhaba! AI ile neler yapabilirim?' } ],
temperature: 0.7,
max_tokens: 2000
}) });
const data =
await response.json(); console.log(data.choices[0].message.content);
import requests url =
"https://api.ailydian.com/v1/chat/completions"
headers = {
"Authorization":
"Bearer sk-lydian-...",
"Content-Type":
"application/json"
} data = {
"model":
"lydian-turbo",
"messages": [ {"role": "user",
"content":
"Merhaba! AI ile neler yapabilirim?"} ],
"temperature":
0.7,
"max_tokens":
2000 } response = requests.post(url, json=data, headers=headers)
print(response.json()["choices"][0]["message"]["content"])
curl https://api.ailydian.com/v1/chat/completions \ -H
"Authorization: Bearer sk-lydian-..." \ -H
"Content-Type: application/json" \ -d
'{ "model": "lydian-turbo", "messages": [ {"role": "user", "content":
"Merhaba! AI ile neler yapabilirim?"} ], "temperature": 0.7, "max_tokens":
2000 }'
Пример ответа
{ "id":
"chatcmpl-abc123",
"object":
"chat.completion",
"created":
1677858242,
"model":
"lydian-turbo",
"choices": [ {
"index": 0,
"message": { "role":
"assistant",
"content":
"Hello! You can do many things with AI..."
},
"finish_reason":
"stop"
} ],
"usage": {
"prompt_tokens":
12,
"completion_tokens":
145,
"total_tokens":
157 } }
Генерация изображений
Создавайте высококачественные изображения из текстовых описаний с помощью LyDian Image Engine и других моделей генерации изображений.
/images/generate
Создавайте изображения профессионального качества из текстовых описаний через конечную точку генерации изображений. Доступны различные варианты размера и качества.
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
promptОбязательный
|
string | Описание изображения (макс. 1000 символов) |
sizeНеобязательный
|
string | "1024x1024", "1792x1024", "1024x1792" (по умолчанию: "1024x1024") |
nНеобязательный
|
integer | Количество изображений для генерации: 1-4 (по умолчанию: 1) |
qualityНеобязательный
|
string | "standard" или "hd" (по умолчанию: "standard") |
Пример запроса
curl https://api.ailydian.com/v1/images/generate \ -H
"Authorization: Bearer sk-lydian-..." \ -H
"Content-Type: application/json" \ -d
'{ "prompt": "Futuristic city with flying cars at sunset", "size": "1024x1024",
"n": 1, "quality": "hd" }'
Доступные модели
Все модели ИИ, доступные на платформе LyDian. Каждая модель обладает различными возможностями и тарифами.
/models
Выводит список всех доступных моделей ИИ. Возможности каждой модели, размер контекстного окна и информация о ценах.
Популярные модели
Коды ошибок
API использует стандартные коды состояния HTTP. Все ответы об ошибках содержат подробную информацию об ошибке в формате JSON.
Коды состояния
| Code | Status | Description |
|---|---|---|
200 |
OK | Запрос выполнен успешно |
400 |
Bad Request | Запрос недействителен или содержит отсутствующие параметры |
401 |
Unauthorized | Ключ API недействителен или отсутствует |
403 |
Forbidden | Ключ API действителен, но не авторизован |
404 |
Not Found | Запрошенный ресурс не найден |
429 |
Rate Limit Exceeded | Отправлено слишком много запросов |
500 |
Internal Server Error | Ошибка сервера |
503 |
Service Unavailable | Сервис временно недоступен |
Формат ответа об ошибке
{ "error": {
"message":
"Invalid API key provided",
"type":
"invalid_request_error",
"code":
"invalid_api_key" } }
Ограничения частоты
Ограничения частоты API применяются на минутной и часовой основе. При превышении лимитов возвращается код состояния 429. Каждый ответ содержит заголовки с информацией о ваших ограничениях частоты.
Лимиты по умолчанию
| Тариф | Запросов/мин | Запросов/час | Токенов/мин |
|---|---|---|---|
| Free | 3 | 100 | 50,000 |
| Pro | 60 | 3,000 | 500,000 |
| Enterprise | Custom | Custom | Custom |
X-RateLimit-Limit, X-RateLimit-Remaining,
X-RateLimit-Reset