Wprowadzenie
P-H3-Image Edycja obrazu używa pierwszego obrazu jako źródła i przyjmuje maksymalnie osiem dodatkowych obrazów referencyjnych. Polecenie tekstowe wskazuje modelowi elementy do zachowania lub zastąpienia.
Najważniejsze funkcje
Odwołaj się do źródła przez <Picture 1>, a do następnego obrazu przez <Picture 2>. Domyślne proporcje wyniku pochodzą z pierwszego obrazu; ustawienie aspect_ratio je zastępuje. Przy edycji dostępne jest wszystkich pięć poziomów rozdzielczości. W naszych testach jedna edycja 4k zwróciła 3360 x 5024 piksele.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Podaj wymagane polecenie edycji; brak polecenia domyślnego. Opisz zmianę i elementy do zachowania, wskazując numery obrazów przy łączeniu źródeł. od 1 znaków · do 5000 znaków |
image_urls | Tak | Wymagana uporządkowana lista 1–9 adresów URL obrazów, bez źródła domyślnego. od 1 elementów · do 9 elementów |
aspect_ratio | Nie | Pomiń to opcjonalne pole, aby przejąć proporcje pierwszego obrazu. Możesz je zastąpić dowolną z 15 obsługiwanych opcji, od 1:3 do 3:1, w tym 9:21 i 21:9; bez opłaty za proporcje. |
resolution | Nie | Domyślny rozmiar edycji to 1k, czyli około 1 megapiksel. Pozostałe opcje to 1.5k (~2,4 MP), 2k (~4 MP), 3k (~9,4 MP) i 4k (~16,8 MP); zmiana poziomu zmienia cenę obrazu. |
output_format | Nie | Zapisz wynik edycji jako jpeg albo wybierz png lub webp. Wszystkie trzy sposoby kodowania mają tę samą cenę. |
seed | Nie | Przy porównywaniu edycji możesz podać wartość źródła losowości; domyślnie nie jest wymagana. |
Cennik
Edytowany wynik jest rozliczany za obraz według poziomu 1k, 1.5k, 2k, 3k lub 4k. Każdy obraz wejściowy po pierwszym dolicza niewielką opłatę; proporcje i kodowanie wyniku nie powodują dopłat. Nieudane żądanie nie jest rozliczane.
| Specyfikacja | Cena |
|---|---|
| $0.03 / obraz |
| $0.048 / obraz |
| $0.066 / obraz |
| $0.138 / obraz |
| $0.21 / obraz |
Zastosowania
Użyj jednego portretu, aby uzyskać nowy strój i otoczenie nad morzem, albo połącz zdjęcie sceny z nową wykonawczynią. W naszych testach z jednym i dwoma źródłami tożsamość wskazanej osoby została zachowana mimo zmiany sceny.
Wskazówki
Na pierwszej pozycji umieść scenę do zachowania, a następnie wskaż, które szczegóły pochodzą z każdego ponumerowanego obrazu. W naszych testach odwrócenie tej kolejności dawało wynik bliższy drugiej scenie. Każda referencja poza pierwszą dolicza niewielką opłatę. Według Pruna AI niższe rozdzielczości mogą dawać więcej artefaktów w detalach.
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": "pruna-ai/p-h3-image/edit",
"input": {
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# 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.
