Erstellen und erlangen
Alle drei Produkte verwenden eine Creations API, so dass Video, Bild und App Ergebnisse die gleiche Liste, Details und Output Workflow teilen.
Laden Sie Quelldateien
Alle Produkte akzeptieren input_file_ids. Erst ein Datei hochladen:
curl -s "https://api.kpainter.ai/openapi/v1/files" \ -H "Authorization: Bearer $KPAINTER_API_KEY" \ -F "file=@./handbook.pdf"Beispiele für die Antwort:
{ "file_id": "file_xxx", "name": "handbook.pdf", "mime_type": "application/pdf", "size_bytes": 248391}Verwenden Sie die zurückgegebene Datei_ID nur innerhalb von Kreationen, die vom gleichen Konto besitzen.
Erstellen
POST /creationsGemeinsame Felder :
| Feld | erforderlich | Bedeutung |
|---|---|---|
| Typ | Ja ja | Video, Bild oder App |
| schnell | Ja ja | Was zu schaffen |
| Anweisungen | nicht | Zusätzliche Anforderungen |
| Input_File_IDs | nicht | Vorher aufgeladenen Quell-IDs |
| Max - Kredite | nicht | Maximale für diese Aufgabe zugelassene Kredite |
| Video / Bild / App | Ja ja | Genau eine Einstellung des Objekts entspricht Typ |
Beispiele :
{ "type": "app", "prompt": "Build a safety quiz with immediate feedback from the handbook", "input_file_ids": ["file_xxx"], "app": { "language": "en" }}Liste und Get
GET /creations?page=1&page_size=20GET /creations?type=video&page=1&page_size=20GET /creations/{id}Nützliche Detailsfelder:
| Feld | Bedeutung |
|---|---|
| Status | Planung, Produktion, Pause, bereit oder nicht |
| Fortschritt - PCT | Monotonische Fortschritte von 0 bis 100 |
| geschätzt_remining_seconds | Nur dann, wenn zuverlässig |
| Schätzungen - Kredite | Aktuelle Schätzungen für diese Aufgabe |
| Real_Glauben | Nettokredite für eine erfolgreiche Aufgabe |
| hat_usable_Dedivery | Ob ein nutzbares Ergebnis bereits vorhanden ist |
| Verfügbar - Aktionen | Aktionen, die derzeit sicher sind, um zu rufen |
| Überprüfung | Eine sichere Explainer-Video-Ausgabe, wenn verfügbar |
| Ergebnisse - Code | Nutzersicheres Ergebniscode |
Normale Versagen vermischen real_credits. Eine unzuverlässige ETA wird eher vergessen als gedacht.
Lesen Sie Ausgänge
GET /creations/{id}/outputsDer Display kehrt nur die Ausgänge zurück. Geben Sie keine URL oder verwenden Sie ein unendliches Zwischenartifakt.
Ein stabiler Kundenfluss
- Lesen Sie die Fähigkeiten.
- Ein gültiges Ersuchen zur Erstellung.
- Poll die gleiche Kreation alle wenige Sekunden.
- Lesen Sie die Ausgänge nach Vorbereitung.
- Wenn es aufgehört ist, zeigen Sie verfügbare_Aktionen und warten Sie auf die erforderliche Benutzer-Aktion.
- Wenn es nicht funktioniert, zeigen Sie den sicheren Grund und lassen Sie den Benutzer die Anfrage überprüfen.
- Wenn der Netzwerkstatus unsicher ist, erhalten Sie die bestehende Schöpfung vor der Erstellung eines anderen.