Rozwiązanie API edycji
Endpointy edycji przyjmują co najmniej dwa wejścia: obraz i instrukcję. To właśnie na wprowadzeniu obrazu – jako publicznego adresu, jako zatwierdzonego pliku albo jako osadzonego data URI – grzęźnie większość wdrożeń.
Wyzwanie
Prompt jest łatwy. Trudniejszy jest plik, który leży w telefonie użytkownika, musi dotrzeć do modelu bez odsłaniania prywatnego zasobnika i musi zmieścić się w limitach egzekwowanych, zanim zadanie w ogóle powstanie.
01
Zadeklarowane pole obrazu przyjmuje publiczny adres HTTPS, zatwierdzony identyfikator pliku spicy:// albo osadzony data URI. Osadzanie ma limit 1 MiB po dekodowaniu i 8 388 608 pikseli na obraz, w treści żądania do 2 MiB. Wszystko większe musi przejść przez bilet przesyłania.
02
Podpisany link może prowadzić do prywatnego bucketu, jeśli nasze serwery pobiorą plik bez cookies i osobnego logowania. Musi być ważny podczas przetwarzania. Prywatne IP, loopback i dane user:password w URL są odrzucane.
03
Publiczna nazwa wywołania kończy się na /edit, schemat zwykle wymaga image_url albo image_urls, a część endpointów dokłada mask_url lub strength. Wartość model z generowania z tekstu wstawiona do przepływu edycji nie przechodzi walidacji, zamiast działać w okrojony sposób.
Podejście
Dla plików użytkowników poproś o bilet przesyłania, wykonaj PUT z dokładną liczbą bajtów i wszystkimi zwróconymi nagłówkami, zatwierdź, a potem podaj zwrócony identyfikator spicy:// w polu obrazu danego modelu. Referencja należy wtedy do twojego konta, jest sprawdzana raz i da się jej użyć w wielu zadaniach bez ponownego przesyłania.
Bilet, PUT, zatwierdzenie, utworzenie. Media dostępne już publicznie pomijają trzy pierwsze kroki.
Ticket → PUT → commit → create
POST /api/v1/common/upload-url
{ "contentType": "image/png", "bytes": 482113 }
→ { "fileId": "fil_01k3…", "uploadUrl": "https://…", "method": "PUT", "headers": { … } }
PUT <uploadUrl> # exactly 482113 bytes, every returned header replayed
POST /api/v1/files/fil_01k3…/commit
→ { "status": "ready", "uri": "spicy://f/fil_01k3…", "sha256": "…" }POST /api/v1/jobs/createTask
{
"model": "<publisher>/<model>/edit",
"input": {
"prompt": "Replace the background with an overcast beach at dusk",
"image_urls": ["spicy://f/fil_01k3m8x9q2z4v7n5p6r8s0t1w3"]
}
}Kontrakt
| Pole lub nagłówek | Wartość lub limit |
|---|---|
| POST /api/v1/common/upload-url | JPEG · PNG · WebP · GIF ≤ 10 MiB |
| POST /api/v1/files/{fileId}/commit | returns spicy://f/fil_… |
| inline data URI | ≤ 1 MiB decoded · ≤ 8192 px per side |
| request body | ≤ 2 MiB · ≤ 16 images |
Przesuń w poziomie, żeby zobaczyć wszystkie kolumny.
Integracja
Dopasowanie
Dowody
Zatwierdzenie porównuje zapisaną liczbę bajtów i typ mediów z biletem, weryfikuje sygnaturę obrazu i liczy SHA-256, zanim plik w ogóle da się przywołać.
Data URI zapisujemy jako pliki przypisane do konta. Znormalizowane wejście zwracane przez recordInfo zawiera identyfikatory plików, nigdy oryginalnych bajtów Base64.
Przesłany materiał trzymamy jeden dzień, a wygenerowane wyniki 14 dni. Oba okna są publikowane, a nie negocjowane dla pojedynczego konta.
Przed startem
FAQ
Modele
Każdy odnośnik prowadzi na stronę danej rodziny modeli: wejścia, limity, zasady dotyczące treści i aktualna cena za jednostkę.
Co dalej
Wyślij obraz, który już masz, razem z instrukcją. Jak trafia do środka referencja, jakie są limity pikseli i za co naliczamy opłatę przy edycji.
