Инструкции

Как запустить генерацию

Выберите тип: картинка, видео, улучшение/изменение видео или описание фото и видео.
Выберите режим качества и подходящую модель.
Опишите задачу в описании: объект, стиль, фон, формат, настроение и ограничения.
При необходимости приложите свои фото: исходное фото, стиль, продукт, персонажа или композицию.
Проверьте примерную стоимость и нажмите «Создать».

Как описать задачу

Лучше писать конкретно: что должно быть в кадре, какой стиль нужен, где будет использоваться результат и чего не должно быть.

Пример: «Квадратная обложка для соцсетей, премиальный минимализм, стеклянный флакон на темном фоне, мягкий студийный свет, без текста и логотипов».

Свои фото

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

REST API

API доступен по адресу https://hayal.tech/api/v1. Создайте API-ключ в профиле и передавайте его в заголовке Authorization: Bearer YOUR_API_KEY.

GET /api/v1/me - баланс и текущий режим. GET /api/v1/models - доступные модели. POST /api/v1/jobs — создать задачу генерации. GET /api/v1/jobs и GET /api/v1/jobs/{id} - история и статус.

curl -X POST https://hayal.tech/api/v1/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"image","model":"sfw-image-1","prompt":"product photo","options":{"ratio":"1:1","quality":"1k","count":1}}'

Пример интеграции: hayal-api-example.php

<?php
declare(strict_types=1);

$apiBase = 'https://hayal.tech/api/v1';
$apiKey = 'YOUR_API_KEY';

function hayalRequest(string $method, string $url, string $apiKey, ?array $payload = null): array
{
    $headers = [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ];

    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => $method,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_TIMEOUT => 60,
    ]);

    if ($payload !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES));
    }

    $body = curl_exec($ch);
    $status = (int)curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
    $error = curl_error($ch);
    curl_close($ch);

    if ($body === false) {
        throw new RuntimeException('HTTP error: ' . $error);
    }

    $data = json_decode((string)$body, true);
    if ($status >= 400) {
        $message = $data['error']['message'] ?? $body;
        throw new RuntimeException('API error ' . $status . ': ' . $message);
    }

    return is_array($data) ? $data : [];
}

// 1. Проверить баланс и режим.
$me = hayalRequest('GET', $apiBase . '/me', $apiKey);
print_r($me);

// 2. Получить доступные модели.
$models = hayalRequest('GET', $apiBase . '/models', $apiKey);
print_r($models);

// 3. Запустить генерацию на генерацию картинки.
$job = hayalRequest('POST', $apiBase . '/jobs', $apiKey, [
    'kind' => 'image',
    'model' => 'sfw-image-1',
    'prompt' => 'Квадратная рекламная картинка товара, студийный свет, чистый фон',
    'options' => [
        'ratio' => '1:1',
        'quality' => '1k',
        'count' => 1,
    ],
    'reference_urls' => [
        // 'https://example.com/reference.jpg',
    ],
]);

print_r($job);

// 4. Проверить статус задачи.
$jobId = $job['data']['id'] ?? null;
if ($jobId) {
    $status = hayalRequest('GET', $apiBase . '/jobs/' . $jobId, $apiKey);
    print_r($status);
}

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

Для бизнеса

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