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

Начните интеграцию с KIE API за несколько минут. Подробные примеры кода и описание всех эндпоинтов.

Содержание

Аутентификация
Быстрый старт
Генерация видео
Генерация изображений
Генерация музыки

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

Все запросы к API требуют API-ключа, который передаётся в заголовке Authorization. Получите ключ в личном кабинете.

# Заголовок авторизации
Authorization: Bearer YOUR_API_KEY
            

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

Три примера, чтобы начать работу с API: cURL, Python и JavaScript.

cURL

curl -X POST https://api.kie.ai/v1/images/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Futuristic city at sunset", "model": "flux-kontext"}'
            

Python

import requests

response = requests.post(
    "https://api.kie.ai/v1/images/generate",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "prompt": "Futuristic city at sunset",
        "model": "flux-kontext"
    }
)

result = response.json()
print(result["image_url"])
            

JavaScript

const response = await fetch('https://api.kie.ai/v1/images/generate', {
    method: 'POST',
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        prompt: 'Futuristic city at sunset',
        model: 'flux-kontext'
    })
});

const data = await response.json();
console.log(data.image_url);
            

Генерация видео

Создавайте видео на основе текстового описания или изображения-референса.

POST /v1/videos/generate

Параметр	Тип	Описание
`prompt`	string	Текстовое описание видео
`model`	string	Модель: `kling`, `runway-gen3`, `pika`
`duration`	integer	Длительность в секундах (5-30)
`aspect_ratio`	string	`16:9`, `9:16`, `1:1`
`image_url`	string	URL референс-изображения (опционально)

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

Генерируйте изображения с помощью различных ИИ-моделей.

POST /v1/images/generate

Параметр	Тип	Описание
`prompt`	string	Текстовое описание изображения
`model`	string	Модель: `flux-kontext`, `4o-image`, `midjourney`
`size`	string	`1024x1024`, `1024x1792`, `1792x1024`
`style`	string	`natural`, `vivid` (опционально)

Генерация музыки

Создавайте музыкальные композиции на основе текстового описания жанра, настроения и стиля.

POST /v1/music/generate

Параметр	Тип	Описание
`prompt`	string	Описание стиля и настроения
`model`	string	Модель: `suno`, `udio`
`duration`	integer	Длительность в секундах (15-240)
`instrumental`	boolean	Только инструментал (опционально)

Получить API-ключ