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
{
"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, которые прочитает любой другой агент.