Skip to main content
POST
Pobierz należącą do Ciebie, niewygasłą miniaturę. Zwraca obraz WebP w formacie base64 w data wraz z mimeType lub natywną zawartość obrazu przez MCP. Obsługiwane są obrazy do 8 MiB.

Uwierzytelnianie i uprawnienia

string
wymagane
Wyślij klucz API VoiceCheap w tym nagłówku. Obsługiwany jest również nagłówek Authorization: Bearer z tym samym kluczem API. Tokeny dostępu OAuth są akceptowane tylko przez MCP, a nie przez ten endpoint REST.
Wymagane uprawnienia: thumbnails:read. Wymagana jest aktywna płatna subskrypcja. Uprawnienia nie zmieniają ról w zespole, własności zasobów, kredytów na multimedia ani limitów planu.

Parametry

string
wymagane
Identyfikator generowania zwrócony przez akcję generowania lub historii.Wzorzec: ^[A-Za-z0-9_-]{1,128}$.
Poniższy JSON Schema zachowuje dokładne nazwy pól, typy zagnieżdżone, wartości domyślne, ograniczenia i akceptowane wartości udostępniane przez mechanizm wykrywania. Dodatkowe reguły zależności między polami znajdują się w uwagach do operacji.

Przykłady żądań

Zastąp przykładowe identyfikatory zasobów i klucze multimediów wartościami zwróconymi dla Twojego konta. Przy ponawianiu tej samej operacji zmieniającej dane zachowaj identyfikator żądania.

Odpowiedź

Pierwsze pomyślne wykonanie zwraca HTTP 200 z wynikiem operacji w data. Ponowienie może zamiast tego zwrócić zapisany stan żądania. Przykład przedstawia jedną obsługiwaną odpowiedź, bez wszystkich opcjonalnych pól. Wygenerowany WebP zwracany jako ciąg base64 w data, wraz z generationId i mimeType. Jest to obiekt JSON, a nie binarna treść odpowiedzi HTTP ani adres URL pobierania.

Pola wyniku

Uwagi do operacji

  • Wymaga thumbnails:read. generationId musi zawierać 1–128 liter ASCII, cyfr, podkreśleń lub łączników.
  • Ta akcja korzysta z własnych utworzonych materiałów i przesłanych plików połączonego użytkownika, również gdy dane uwierzytelniające są połączone w kontekście zespołu.
  • Miniatura musi być przypisana do połączonego użytkownika, mieć w magazynie status claimed i nie być przeterminowana. Nowe miniatury konta są przechowywane przez siedem dni; sprawdzaj expiresAt dla każdego wyniku.
  • Zdekodowany WebP może mieć maksymalnie 8 MiB (8,388,608 bajtów). Kodowanie Base64 sprawia, że ciąg JSON jest większy niż plik binarny.
  • Zdekoduj data jako base64, aby zapisać WebP. Nie ma prefiksu URL data:. Przez MCP serwer zwraca natywną zawartość obrazu i blok tekstowy zawierający generationId zamiast tego standardowego wyniku JSON.

Wykorzystanie

Każde pomyślne wywołanie zużywa jedno wywołanie z miesięcznego limitu API/MCP. Obowiązują również kredyty na multimedia oraz limity generowania danej operacji.

Błędy