Wprowadzenie
Przyjmuje jeden portret i zwraca wygenerowany obraz najbliższego sobowtóra wśród celebrytów. Nie ma promptu ani parametrów: zdjęcie jest całym wejściem.
Żądanie to jeden URL obrazu, rozliczany za żądanie. To funkcja na jedno wywołanie, przygotowana dla produktów rozrywkowych i społecznościowych, a nie narzędzie do identyfikacji.
Najważniejsze funkcje
Jedno zdjęcie na wejściu, jeden kadr na wyjściu — nic więcej do wysłania
Całe żądanie to jeden URL obrazu. Nie ma promptu, seeda, rozmiaru ani siły, więc wgrane zdjęcie jest jedyną rzeczą, która wpływa na wynik. Wyślij je i odpytuj zadanie o kadr, tak samo jak przy każdym innym wywołaniu mediów w tym katalogu; cena za żądanie jest taka sama bez względu na to, kto pojawi się w kadrze.
Wygenerowany kadr, a nie nazwisko czy wynik
Odpowiedź zawiera jeden obraz i nic więcej: bez nazwiska celebryty, bez rankingu kandydatów, bez procentu podobieństwa. To, co stoi obok kadru, jest twoim tekstem, a nie twierdzeniem modelu — i tak jest bezpieczniej. Buduj doświadczenie wokół samego kadru: pokaż go, pozwól go udostępnić i nie stawiaj obok niego liczby.
Decydując, czy wolno ci go użyć, traktuj go jak rozpoznawanie twarzy
Wejściem jest zawsze twarz prawdziwej osoby, co podporządkowuje ten endpoint przepisom o wizerunku i danych biometrycznych, których nie dotyczy nic innego w tym katalogu. Dane biometryczne są osobno regulowane w Unii Europejskiej i w części Stanów Zjednoczonych, a poprzeczka zgody bywa tam wysoko. Wysyłaj tylko zdjęcia, na które osoba na nich świadomie się zgodziła — nigdy zdjęcia osób publicznych, nigdy obrazy wzięte skądinąd — i nigdy nie używaj go do identyfikacji, weryfikacji, inwigilacji ani budowania bazy twarzy. Nic, co wraca, nie jest stwierdzeniem faktu o prawdziwej osobie; przesłane obrazy źródłowe są usuwane po jednym dniu, a wygenerowane wyniki po 14 dniach.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
image_url | Tak | Jeden wyraźny, mniej więcej frontalny portret z jedną dobrze widoczną twarzą. od 1 znaków |
Cennik
$0.05 / żądanie
Dopasowanie, którego byś nie wybrał, wciąż jest ukończonym żądaniem i jest płatne.
Zastosowania
Jedno przesłanie, jeden kadr do udostępnienia
Używaj tego endpointu, gdy doświadczenie w produkcie to przesłanie jednego zdjęcia i wygenerowany kadr do udostępnienia. Wyślij portret jako image_url, odpytaj zadanie i pokaż zwrócony obraz; nie ma nazwiska ani wyniku, które dałoby się pokazać obok.
Funkcje rozrywkowe i społecznościowe
Interakcja „do której gwiazdy jesteś podobny?” jako jedno wywołanie API za przesłaniem zdjęcia. To moment do udostępnienia w aplikacji konsumenckiej, a nie narzędzie produkcyjne.
Mechaniki kampanii
Lekki, interaktywny krok w ścieżce marketingowej: wgraj selfie, odbierz kadr do udostępnienia. Jedno wywołanie na uczestnika utrzymuje przewidywalny koszt.
Aplikacje fotograficzne i beauty
Zabawna funkcja obok istniejących narzędzi do portretów. Nie wymaga inżynierii promptów ani parametrów, więc wchodzi do aplikacji z jednym polem formularza.
Wskazówki
Spodziewaj się obrazu, nie werdyktu
Endpoint zwraca wygenerowany kadr, a nie nazwisko, ranking czy wynik podobieństwa. Jeśli twój produkt potrzebuje etykiety, musisz pokazać sam kadr — API nie daje nic innego do wyświetlenia.
Wyślij wyraźny portret en face
Jedna dobrze oświetlona twarz, mniej więcej zwrócona do aparatu, zajmująca rozsądną część kadru. Zdjęcia grupowe, mocne profile, okulary przeciwsłoneczne, rozmycie ruchu i bardzo małe twarze to sytuacje, w których dopasowanie słabnie albo wywołanie całkiem się nie udaje.
Sprawdź wynik, zanim zaczniesz iterować
Jedna twarz na obrazie, mniej więcej frontalnie i wyraźnie oświetlona. Ujęcia z profilu, zasłonięcia (okulary przeciwsłoneczne, dłonie, włosy na twarzy), rozmycie ruchu i bardzo małe twarze pogarszają dopasowanie albo powodują błąd wywołania. Nie ma promptu, maski, siły ani seeda: jeśli wynik jest zły, jedynym rozwiązaniem jest inne zdjęcie. Odpowiedź to obraz i nic więcej — bez nazwiska, rankingu i wartości pewności.
Szybki start z API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/look-alike-v1/edit",
"input": {
"image_url": "https://example.com/reference.png"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.