API замены лиц

Фото и видео, из вашего кода.

Отправьте лицо и файлы, в которые его нужно вставить. Опрашивайте задачу или примите подписанный вебхук, когда она завершится. Движок и цены те же, что в приложении, а оплата идёт предоплаченными swapz из кошелька, к которому привязан ключ. Тем же ключом можно увеличивать фото до 2K, 4K или 8K.

7 эндпоинтов и заголовок x-api-key. Открыть справочник

Launch

curl -X POST "https://faceswap.ing/api/v1/faceswap/tasks" \
  -H "x-api-key: $FACESWAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "faceImageUrl": "https://example.com/face.jpg",
    "targetFiles": [{ "url": "https://example.com/photo.jpg" }]
  }'
const API = "https://faceswap.ing/api/v1";
const headers = { "x-api-key": process.env.FACESWAP_API_KEY };

const response = await fetch(`${API}/faceswap/tasks`, {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({
    faceImageUrl: "https://example.com/face.jpg",
    targetFiles: [{ url: "https://example.com/photo.jpg" }],
  }),
  // Every file is screened before anything is priced: allow a minute.
  signal: AbortSignal.timeout(120_000),
});

const launch = await response.json();

// A refusal is an application/problem+json document: branch on its code.
if (!response.ok) throw new Error(`${response.status} ${launch.code}: ${launch.detail ?? launch.title}`);

// Set when the launch stopped part-way: data still lists the tasks it created.
if (launch.refusal) console.warn(launch.refusal.code, launch.refusal.detail);

const taskIds = launch.data.map((task) => task.taskId);
import os
import time

import requests

API = "https://faceswap.ing/api/v1"
HEADERS = {"x-api-key": os.environ["FACESWAP_API_KEY"]}

response = requests.post(
    f"{API}/faceswap/tasks",
    headers=HEADERS,
    json={
        "faceImageUrl": "https://example.com/face.jpg",
        "targetFiles": [{"url": "https://example.com/photo.jpg"}],
    },
    # Every file is screened before anything is priced: allow a minute.
    timeout=120,
)
launch = response.json()

# A refusal is an application/problem+json document: branch on its code.
if not response.ok:
    raise RuntimeError(f"{response.status_code} {launch['code']}: {launch.get('detail', launch['title'])}")

# Set when the launch stopped part-way: data still lists the tasks it created.
if launch["refusal"]:
    print(launch["refusal"]["code"], launch["refusal"].get("detail"))

task_ids = [task["taskId"] for task in launch["data"]]

Response, shortened

json
{
  "data": [
    {
      "taskId": "01a08066-5d70-7000-a3db-ff3ef6b651ca",
      "status": "queued",
      "files": [
        {
          "id": "01a08066-5d70-7fff-9e92-493cc98e0da6",
          "status": "pending",
          "targetUrl": "https://example.com/photo.jpg",
          "outputUrl": null
        }
      ]
    }
  ],
  "refusal": null
}

Как работает задача

Запуск
Один POST запускает задачу с лицом и целевыми файлами, до 200 файлов за раз. Фото и видео можно отправлять вместе.
Результат
Читайте задачу, пока она не завершится, или примите подписанный вебхук по её завершении.
Кошелёк
Ключ привязан к одному кошельку и тратит его предоплаченные swapz. Цены те же, что в приложении.

Апскейл фото

Один POST увеличивает за раз до 50 фото, каждое в 2K, 4K или 8K, по ссылке на ваш файл или из замены, сделанной вашей командой. У апскейла свои маршруты и своё событие вебхука.

7 эндпоинтов, один заголовок

Каждый запрос передаёт ваш ключ в заголовке x-api-key.

  • GET /api/v1/facesСписок лиц, сохранённых в команде ключа.
  • POST /api/v1/faceswap/tasksЗапуск свопа на фото и видео.
  • GET /api/v1/faceswap/tasksСписок ваших задач.
  • GET /api/v1/faceswap/tasks/:taskIdОдна задача и её статус.
  • POST /api/v1/upscalesАпскейл фото до 2K, 4K или 8K.
  • GET /api/v1/upscalesСписок ваших апскейлов.
  • GET /api/v1/upscales/:upscaleIdОдин апскейл и его статус.

Документ OpenAPI доступен по адресу /api/v1/openapi.json.

30 запусков за 60 секунд, до 200 файлов в каждом

Чтение
120 запросов за 60 секунд на каждый ключ.
Запуски
30 запусков задач за 60 секунд на каждый ключ, отдельно от чтения.
Сверх лимита
Запрос получает ответ 429 с заголовком Retry-After, где указано, когда повторить.
Файлов в задаче
До 200 целевых файлов и 4 ГБ входных данных.
Фото
До 50 МБ и 50 МП каждое.
Видео
До 1 ГБ на файл и 8,9 МП на кадр. Максимальная длина зависит от кадра: 5 мин до 1440p и 4 мин 30 с до 4K.
Вебхуки
Подписаны HMAC-SHA256. Неудачная доставка повторяется, всего до 6 попыток.

0,05 $ за фото, от 0,03 $ за секунду видео

Один swapz стоит 0,01 $. Вызов стоит столько же, сколько сам своп. Платы за запрос нет.

Цены по прайсу, без опций. Видео оплачивается минимум за 10 секунд. Задача резервирует свою цену при запуске и рассчитывается один раз, по завершённым генерациям, поэтому за неудачную генерацию swapz возвращаются. Все цены

Встраивается в ваш текущий пайплайн

Обычный HTTPS и JSON с одним заголовком. Пакетный скрипт, обработчик очереди или HTTP-шаг в n8n, Make или Zapier запускает свопы и забирает результаты, а подписанный вебхук сообщает вашей системе, когда задача завершилась.

  • Быстрый стартПервый своп на curl, JavaScript или Python, затем опрос статуса, вебхуки, повторы и пакетная обработка.
  • Интерактивный справочникВсе эндпоинты и поля, готовый код и запрос, который можно отправить своим ключом.
  • Навык для агентовНавык для Claude, а также Markdown-файл и документ OpenAPI, которые прочитает любой другой агент.