MiniMax H3 Image Highspeed

Szybki przykład

Wyślij jedno żądanie obrazu, zapisz zwrócone id i odpytuj o stan, aż zadanie osiągnie completed lub failed. To API korzysta z zadań asynchronicznych i wyników w postaci adresów URL.

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"minimax-h3-image-highspeed","prompt":"An amber bottle on pale limestone in soft morning light","area":"1K","aspect_ratio":"3:2"}'

Punkt końcowy i nagłówki

POST https://api.seedrouter.ai/v1/images/generations

Przechowuj klucz na swoim serwerze. Sukces HTTP potwierdza przyjęcie zadania; nie oznacza, że obraz jest gotowy.

Parametry

Akceptowanych jest 13 pól. Wymagane są tylko model i prompt. Pomiń pola opcjonalne, aby użyć wartości domyślnych; żadne pole nie akceptuje null. Playground udostępnia ustalony model i dziesięć edytowalnych pól wejściowych. Format odpowiedzi URL i dostarczanie zadań bez strumieniowania są ustalone.

Zależności rozmiaru i promptu

Jawnie podane size musi zawierać dodatnie całkowite wymiary o polu powierzchni od 655 360 do 20 000 000 pikseli włącznie. Szerokość podzielona przez wysokość musi wynosić od 1/3 do 3. Na przykład 2048x1152 jest poprawne. Gdy podajesz jawne wymiary, pomiń zarówno aspect_ratio, jak i area, nawet jeśli ich wartością byłoby auto.

Gdy rozmiar jest pominięty lub ustawiony na auto, używaj aspect_ratio razem z area. Pole powierzchni jest rozmiarem docelowym; sprawdź dostarczony plik, aby poznać dokładne wymiary. Nie oznacza ono stałej ceny za pojedynczy obraz.

Ustawienie disable_prompt_enhanced: true wymaga jawnego rozmiaru w pikselach lub stałych proporcji. Przy wyłączonym ulepszaniu model odczytuje około pierwszych 4096 tokenów promptu. Limit przesyłania wynoszący 32 000 znaków nadal obowiązuje. Edycja zawsze ulepsza prompty, więc true jest odrzucane, gdy występuje images.

Nie są akceptowane pola maski, ziarna losowości, stylu, jakości, negatywnego promptu, tła ani osobnej rozdzielczości. Nieznane parametry zwracają błąd przed przesłaniem. To API nie oferuje strumieniowania, obrazów base64 ani wyjścia WebP.

Obrazy referencyjne

Używaj publicznie dostępnych adresów URL HTTP(S) bez osadzonych danych uwierzytelniających. Każdy obraz musi być w formacie JPEG, PNG, WebP, HEIC lub HEIF; mieć najwyżej 64 MiB; 128–8192 piksele na każdym boku; oraz stosunek dłuższego boku do krótszego najwyżej 4. Rozmiar treści JSON nie może przekraczać 64 MiB. Pliki obrazów są wskazywane przez URL, a ich bajty nie są osadzane w treści JSON.

Przypisz jasny cel każdemu obrazowi referencyjnemu i opisz, co ma pozostać niezmienione. Kolejność tablicy określa <Picture 1>, <Picture 2> i tak dalej.

{
  "model": "minimax-h3-image-highspeed",
  "prompt": "Use <Picture 1> as the product and <Picture 2> as the setting. Preserve the product's shape and label. Match the setting's light and perspective.",
  "images": [
    {"image_url": "https://example.com/product.jpg"},
    {"image_url": "https://example.com/setting.jpg"}
  ],
  "aspect_ratio": "3:2",
  "area": "2K",
  "n": 1,
  "output_format": "png"
}

Zastąp przykładowe adresy URL własnymi dostępnymi plikami obrazów.

Rozliczenia

Rozliczenia obejmują trzy kategorie tokenów: wejście tekstowe, wejście obrazowe i wyjście obrazowe. Pomnóż rzeczywiste zużycie w każdej kategorii przez jej bieżącą stawkę. Liczba wyników, wymiary obrazów i obrazy referencyjne wpływają na zużycie; nazwy rozdzielczości nie określają stałej kwoty rachunku. Nieudane żądania nie są płatne. Zobacz bieżący cennik.

Odpowiedź zadania i odpytywanie

Przyjęte żądanie zwraca zadanie asynchroniczne:

{"id":"task_example","model":"minimax-h3-image-highspeed","status":"processing"}

curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Odpowiedź zakończonego zadania zawiera adresy URL obrazów w output.data. Każdy dostarczony obraz zawiera swoje size i może zawierać revised_prompt (ulepszony opis). output.created to czas utworzenia w sekundach Unix, a output.output_format określa dostarczony format. output.usage udostępnia liczby tokenów wejścia tekstowego, wejścia obrazowego i wyjścia obrazowego oraz liczbę dostarczonych generated_images. Poniższe adresy URL i identyfikatory są przykładowe:

{
  "id": "task_example",
  "model": "minimax-h3-image-highspeed",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.jpg"}]}
}

Odpytuj co 10–20 sekund. Przekroczenie limitu czasu klienta nie oznacza nieudanego zadania: zachowaj jego identyfikator i kontynuuj odpytywanie zamiast wysyłać zduplikowane żądanie. Publiczne odpowiedzi nie zawierają salda konta ani kosztów.

Błędy

Błędy HTTP używają formatu {"error":{"code":integer,"message":string}}. Nieudane zadanie ma status: "failed" i błąd. Popraw nieprawidłowe parametry przed nowym przesłaniem. Zobacz wspólny katalog błędów i cykl życia zadania.

Powiązane strony

• MiniMax H3 Image Highspeed Playground i cennik
• MiniMax H3 Image