Modelle auflisten
GET /v1/models
Liefert die derzeit verfügbaren Bild- und Videomodelle. Nur Modelle mit hinterlegten Zugangsdaten und aktivem Status erscheinen, die Liste kann sich also ändern – hol sie beim Start deiner Anwendung, statt ids fest zu verdrahten.
Anfrage
bash
curl https://open.pikpikgo.com/v1/models \
-H "Authorization: Bearer $PIKPIK_API_KEY"Antwort
json
{
"object": "list",
"data": [
{
"id": "img-std-1",
"object": "model",
"type": "image",
"credits": 10,
"max_reference_images": 4,
"specs": [
{ "key": "2k", "name": "2K", "resolution": "2k", "quality": "2k", "credits": 10, "min_sec": 0, "max_sec": 0 }
]
}
]
}Felder
| Feld | Beschreibung |
|---|---|
| id | Modellkennung. Genau dieser Wert gehört in model; eine id außerhalb dieser Liste wird abgelehnt statt still durch das Standardmodell ersetzt |
| type | image, video oder text |
| credits | Preis. Pro Bild bei Bildmodellen; pro Anfrage bei Videomodellen ohne Stufen |
| max_reference_images | Wie viele Referenzbilder akzeptiert werden. 0 heißt: nicht unterstützt |
| aspect_ratios | Nur Video. Vom Modell akzeptierte Seitenverhältnisse; ein leeres Array heißt: keine Einschränkung. Was nicht in der Liste steht, wird abgelehnt |
| supports_last_frame | Nur Video. false heißt: nur erstes Bild — image_last wird abgelehnt |
| max_reference_videos | Nur Video. Wie viele Referenzvideos akzeptiert werden. 0 heißt: nicht unterstützt |
| max_reference_audios | Nur Video. Wie viele Referenzaudios akzeptiert werden. 0 heißt: nicht unterstützt |
| specs | Verfügbare Stufen. Mit spec kommen Auflösung und Preis aus der Stufe |
| specs[].credits | Videopreis: billing=per_sec wird mit der Dauer multipliziert; billing=per_unit nicht |
| specs[].min_sec / max_sec | Erlaubter Dauerbereich in Sekunden. Werte außerhalb werden begrenzt |
Bei Bild und Video greift ohne model das Standardmodell der Plattform, das sich mit der Zeit ändern kann – wer Stabilität braucht, gibt es explizit an. Einträge mit type text gehören zu /v1/chat/completions, wo model Pflicht ist und keinen Standard hat.