Bildauftrag abrufen

GET /v1/tasks/{id}

Liest den Stand eines Bildauftrags. Du brauchst ihn nur, wenn du async: true übergeben hast – ein synchroner Standardaufruf liefert die Bilder bereits selbst. Videoaufträge werden hier nicht bedient, dafür ist GET /v1/video/generations/{task_id} zuständig.

Anfrage

curl https://open.pikpikgo.com/v1/tasks/2608101909450810293847 \
  -H "Authorization: Bearer $PIKPIK_API_KEY"

Antwort

{
  "id": "2608101909450810293847",
  "object": "image.generation",
  "created": 1786000185,
  "model": "img-std-1",
  "status": "succeeded",
  "prompt": "eine regennasse Cyberpunk-Straße bei Nacht, Neonspiegelungen",
  "size": "16:9",
  "quality": "2k",
  "credits": 10,
  "error": "",
  "data": [
    { "url": "https://cdn.pikpikgo.com/ai/xxxx.png", "revised_prompt": "eine regennasse Cyberpunk-Straße bei Nacht, Neonspiegelungen" }
  ]
}

Statusverlauf

Empfehlungen zum Pollen

• Alle 3 Sekunden bei Bildern (bei Video alle 5, an dessen eigenem Endpunkt). Häufiger verbraucht nur Rate-Limit und beschleunigt nichts.
• Setze eine Obergrenze (etwa 10 Minuten für Bilder, 30 für Video) und behandle sie als Timeout. Keine Endlosschleife.
• Der Prozess muss nicht durchgehend laufen: Ein Hintergrunddienst schließt liegengebliebene Aufträge ab und erstattet Fehlschläge.