OneKeyModel LogoOneKeyModel

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

Легко интегрируйте модели генерации текста, изображений и видео через единый OpenAI-совместимый API.

Базовый URL и Аутентификация

Все запросы к API требуют единого Base URL и вашего API-ключа (Token) в заголовке Authorization.

Base URL
https://api.onekeymodel.com/v1
Формат заголовка Authorization
Authorization: Bearer YOUR_API_KEY

API текстовых моделей (Chat Completions)POST /v1/chat/completions

Используется для диалогов, написания кода, перевода и т.д. Полностью совместим со стандартом OpenAI `/v1/chat/completions`.

Пример cURL

bash
curl https://api.onekeymodel.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello!"}
    ]
  }'

Пример на Python

python
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.onekeymodel.com/v1"
)

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"}
    ]
)

print(response.choices[0].message.content)

API генерации изображений (Image Generations)POST /v1/images/generations

Используется для создания изображений. Поддерживает Midjourney, DALL-E 3, wan2.7-image и другие модели.

Пример cURL

bash
curl https://api.onekeymodel.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -d '{
    "model": "wan2.7-image",
    "prompt": "A beautiful sunset over the mountains, digital art",
    "n": 1,
    "size": "1024x1024"
  }'

Пример на Python

python
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.onekeymodel.com/v1"
)

response = client.images.generate(
    model="wan2.7-image",
    prompt="A beautiful sunset over the mountains, digital art",
    n=1,
    size="1024x1024"
)

print(response.data[0].url)

API генерации видео (Video Generations)

Поскольку генерация видео занимает больше времени (например, wan2.7-t2v), процесс состоит из двух этапов: отправка задачи и запрос статуса.

Шаг 1: Отправка задачи на генерациюPOST /v1/videos
Отправьте параметры генерации в API. Вы сразу получите запись о задаче со статусом `in_progress` или `queued`, содержащую `id` (task_id).
bash
curl -X POST https://api.onekeymodel.com/v1/videos \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -d '{
    "model": "wan2.7-t2v",
    "prompt": "A futuristic city in cyberpunk style, flying cars",
    "resolution": "1280*720"
  }'

# Response Example:
# {
#   "id": "148ed382-b7e1-4357-9d29-c70f61cd3a2f",
#   "status": "in_progress",
#   "created_at": 1715865000
# }
Шаг 2: Запрос статуса задачиGET /v1/videos/:task_id
Используйте `id` из предыдущего шага, чтобы запрашивать статус задачи каждые несколько секунд. Когда статус изменится на `succeeded` или `completed`, будет доступна ссылка на итоговое видео.
bash
curl -X GET "https://api.onekeymodel.com/v1/videos/148ed382-b7e1-4357-9d29-c70f61cd3a2f" \
  -H "Authorization: Bearer $YOUR_API_KEY"

# Response Example (When Finished):
# {
#   "id": "148ed382-b7e1-4357-9d29-c70f61cd3a2f",
#   "status": "succeeded",
#   "created_at": 1715865000,
#   "video_url": "https://example.com/video.mp4"
# }