📚 Документація API (Gateway)

🔑 Авторизація (Headers)

Для всіх запитів необхідно передавати твій персональний API-ключ у заголовку x-api-key. Також не забувай вказувати Content-Type: application/json.

headers: {
    'x-api-key': 'sk-твоя-секретна-строка-ключа',
    'Content-Type': 'application/json'
}

❌ Обробка помилок (HTTP Status Codes)

1. Генерація зображень

Приклад запиту (JavaScript/Node.js):

const response = await fetch('http://178.63.149.102:8080/api/generate', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'x-api-key': 'твій-ключ' },
    body: JSON.stringify({
        prompt: "A futuristic cyberpunk city at night, neon lights, 8k resolution",
        model: "flux",
        width: 1024,
        height: 1024,
        steps: 30,
        cfg: 7,
        seed: 123456789
    })
});

const result = await response.json();
console.log(result.data); // Зображення у форматі Base64
console.log(result.balanceRemaining); // Залишок токенів: 99

2. Анімація (Image to Video)

Примітка: цей запит може виконуватися довго, переконайтеся, що ваш клієнт має достатній timeout (рекомендується 3-5 хвилин).

Приклад запиту:

const response = await fetch('http://178.63.149.102:8080/api/animate', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'x-api-key': 'твій-ключ' },
    body: JSON.stringify({
        base64Image: "iVBORw0KGgoAAAANSUhEUgAA...", // Ваша картинка
        prompt: "The camera slowly pans to the right, wind blowing the hair",
        fps: 121,
        seed: 42
    })
});
const result = await response.json();
// result.data міститиме відео у Base64

3. Редагування (Inpainting)

4. Покращення якості (Upscale)

5. Видалення фону (Background Removal)

6. Чат та Аналіз (Text / Vision / Video)

Універсальний роут для роботи з мовними моделями (LLM). Підтримує всі стандартні параметри OpenAI (LM Studio).

Приклад 1: Звичайний текст зі строгим JSON

const response = await fetch('http://178.63.149.102:8080/api/chat', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'x-api-key': 'твій-ключ' },
    body: JSON.stringify({
        task: "text",
        temperature: 0.7,
        messages: [
            { role: "system", content: "You are a helpful assistant." },
            { role: "user", content: "Tell me a joke." }
        ],
        response_format: {
            type: "json_schema",
            json_schema: {
                name: "joke_response",
                strict: true,
                schema: {
                    type: "object",
                    properties: { joke: { type: "string" } },
                    required: ["joke"]
                }
            }
        }
    })
});
const result = await response.json();
// result.data.text буде чистим JSON об'єктом: {"joke": "Why did the chicken..."}

Приклад 2: Аналіз фотографії (Vision)

Щоб проаналізувати фото або кадри з відео, передай task: "vision" та зміни структуру повідомлення користувача:

const response = await fetch('http://178.63.149.102:8080/api/chat', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'x-api-key': 'твій-ключ' },
    body: JSON.stringify({
        task: "vision",  
        messages: [
            {
                role: "user",
                content: [
                    { type: "text", text: "Що зображено на цьому фото?" },
                    { type: "image_url", image_url: { url: "data:image/jpeg;base64,iVBORw0KGgo..." } }
                ]
            }
        ]
    })
});

7. Генерація музики (Text-to-Music)

Створює повноцінний аудіотрек на основі текстового опису жанру, настрою та (опціонально) лірики. Запит може виконуватися довго (до декількох хвилин).

Приклад запиту (JavaScript):

const response = await fetch('http://178.63.149.102:8080/api/text2music', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'x-api-key': 'твій-ключ' },
    body: JSON.stringify({
        prompt: "Epic orchestral soundtrack with heavy drums and choir",
        lyrics: "",
        audio_duration: 30
    })
});

const result = await response.json();
// result.data містить бінарні дані аудіофайлу у форматі Base64
console.log("Залишок токенів:", result.balanceRemaining);

8. Синтез мовлення (Text-to-Speech)

Приймає текстовий запит і повертає згенероване аудіо (голос людини) у форматі WAV, закодоване в Base64.

Приклад запиту (JavaScript):

const response = await fetch('http://178.63.149.102:8080/api/synthesize', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'x-api-key': 'твій-ключ' },
    body: JSON.stringify({
        text: "Привіт! Це тестове повідомлення для синтезу голосу.",
        voice: "Марина Панас"
    })
});

const result = await response.json();
if (result.data.success) {
    // result.data.audio - це рядок Base64 (WAV формат)
    const audio = new Audio("data:audio/wav;base64," + result.data.audio);
    audio.play();
}

9. Розпізнавання мовлення (Speech-to-Text / STT)

Приймає аудіофайл (наприклад, голосове повідомлення) і повертає розпізнаний текст.

Приклад запиту (JavaScript):

const response = await fetch('http://178.63.149.102:8080/api/stt', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'x-api-key': 'твій-ключ' },
    body: JSON.stringify({
        base64Audio: "UklGRiQAAABXQVZFZm10IBAAAAABAAEA..." // Ваш аудіофайл у Base64
    })
});

const result = await response.json();
// result.data міститиме розпізнаний текст
console.log("Розпізнаний текст:", result.data);