Загрузка Файла По Url

POST /files/upload-by-url

Загружает файл по публичному URL на хостинг и возвращает постоянную ссылку. Используйте полученный file_url в качестве референса при создании задач генерации (поля image_input, input_urls, imageUrls и т.п.).

Поддерживаемые форматы: JPEG, PNG, WebP, MP4, MOV и другие.

Лимит: 20 запросов / минуту.

Базовый URL: https://api.aihere.ru/api/v1
Авторизация: Authorization: Bearer <API-ключ>
Rate-limit: 20 запросов/мин (upload-by-url), 10 запросов/мин (base64/stream)

Параметры

Поле	Тип	Обяз.	Описание
file_url	string	да	—
upload_path	string	—	по умолчанию: "developer-uploads"

Примеры

cURL

curl -X POST "https://api.aihere.ru/api/v1/files/upload-by-url" \
  -H "Authorization: Bearer $AIHERE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "file_url": "https://example.com/image.jpg",
  "upload_path": "developer-uploads"
}'

python

import requests

payload = {
    "file_url": "https://example.com/image.jpg",
    "upload_path": "developer-uploads"
}

resp = requests.post(
    "https://api.aihere.ru/api/v1/files/upload-by-url",
    headers={
        "Authorization": f"Bearer {API_KEY}",
    },
    json=payload,
    timeout=60,
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch("https://api.aihere.ru/api/v1/files/upload-by-url", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "file_url": "https://example.com/image.jpg",
  "upload_path": "developer-uploads"
}),
});
if (!resp.ok) throw new Error(`HTTP ${resp.status}: ${await resp.text()}`);
console.log(await resp.json());

php

$payload = json_decode('{"file_url": "https://example.com/image.jpg", "upload_path": "developer-uploads"}', true);

$ch = curl_init('https://api.aihere.ru/api/v1/files/upload-by-url');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode($payload),
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $apiKey",
        'Content-Type: application/json',
    ],
]);
$resp = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($resp);

Ответ 200

URL файла на хостинге

{
  "file_url": "https://example.com/image.jpg",
  "upload_path": "string"
}

Ошибки

Код	Причина
400	Некорректный URL или параметры запроса
429	Превышен rate-limit
502	Ошибка провайдера генерации
422	Ошибка валидации тела запроса (detail содержит список полей)
401	Нет или невалидный API-ключ