Старт

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

Чтобы начать использовать LyDian API, сначала вам понадобится ключ API. Вы можете создать свой ключ API в панели управления и сразу же начать его использовать.

              
              Безопасность ключа API
            
              Никогда не публикуйте свой ключ API в открытых репозиториях. Храните его в переменных
              окружения и используйте только в доверенных приложениях.

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

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

Все запросы API требуют ключа API в заголовке Authorization. Отправляйте свой ключ API как Bearer-токен.

Заголовок HTTP

HTTP

Authorization: Bearer YOUR_API_KEY

Конечная точка

Базовый URL

Базовый URL для всех конечных точек API. В продакшен-среде всегда используйте HTTPS.

URL

https://api.ailydian.com/v1

Чат

Завершение чата

Основная конечная точка для общения с моделями LyDian AI. Потоковый (streaming) и непотоковый режимы. Используйте потоковый режим для ответов в реальном времени.

POST

/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)

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

JavaScript

                  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);
                

Python

                  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

                  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 }'
                

Пример ответа

JSON

                { "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 и других моделей генерации изображений.

POST

/images/generate

Создавайте изображения профессионального качества из текстовых описаний через конечную точку генерации изображений. Доступны различные варианты размера и качества.

Параметры запроса

Параметр	Тип	Описание
`prompt`Обязательный	string	Описание изображения (макс. 1000 символов)
`size`Необязательный	string	"1024x1024", "1792x1024", "1024x1792" (по умолчанию: "1024x1024")
`n`Необязательный	integer	Количество изображений для генерации: 1-4 (по умолчанию: 1)
`quality`Необязательный	string	"standard" или "hd" (по умолчанию: "standard")

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

cURL

                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. Каждая модель обладает различными возможностями и тарифами.

GET

/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	Сервис временно недоступен

Формат ответа об ошибке

JSON

                { "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

Справочник API
Для разработчиков

Ваш ключ API

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

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

Заголовок HTTP

Базовый URL

Завершение чата

/chat/completions

Параметры запроса

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

Пример ответа

Генерация изображений

/images/generate

Параметры запроса

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

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

/models

Популярные модели

Коды ошибок

Коды состояния

Формат ответа об ошибке

Ограничения частоты

Лимиты по умолчанию

Справочник API Для разработчиков

Ваш ключ API

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

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

Заголовок HTTP

Базовый URL

Завершение чата

/chat/completions

Параметры запроса

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

Пример ответа

Генерация изображений

/images/generate

Параметры запроса

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

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

/models

Популярные модели

Коды ошибок

Коды состояния

Формат ответа об ошибке

Ограничения частоты

Лимиты по умолчанию

Справочник API
Для разработчиков