Rezepte
Drei kurze Abläufe von Anfang bis Ende — ein Bild erzeugen und holen, einen Reel-Entwurf bauen, die Ausgaben im Blick behalten.
Drei Abläufe, die die Werkzeuge zusammensetzen. Jeder ist vollständig: zwischen den Aufrufen fehlt nichts.
Ein Bild erzeugen und holen
generate_image kommt zurück, sobald der Auftrag angenommen ist, nicht wenn das Bild
existiert. Die Adresse kommt von get_asset.
Die Marke wählen. list_brands gibt dir die IDs. Ein Schlüssel gehört zu einem
Arbeitsbereich, du siehst also immer nur deine eigenen.
Den Auftrag starten. generate_image mit brand_id, prompt und modelKey. Die
Antwort trägt asset_id, status: "generating" und was es gekostet hat.
get_asset abfragen mit dieser ID, bis status nicht mehr generating ist. Einen
Webhook gibt es dafür noch nicht — ein paar Sekunden zwischen den Aufrufen reichen.
Bevor du es veröffentlichst
Was du zurückbekommst, ist das Original: mit C2PA signiert, aber ohne sichtbares Kennzeichen. Wenn du es selbst verteilst, ist die sichtbare Offenlegung deine — siehe KI-Kennzeichnung.
Einen Reel-Entwurf bauen
create_composition plant und setzt einen Entwurf in deinem Arbeitsbereich zusammen. Es
veröffentlicht nichts, und der Entwurf selbst wird nicht abgebucht.
Ruf create_composition mit brand_id, idea, duration_target_sec und mode
auf. Nimm fit_to_time, wenn die Länge wichtiger ist als die Vollständigkeit, und
fit_to_idea, wenn es umgekehrt ist.
Öffne ihn in Ikrames. Die Antwort trägt eine composition_id. Aus einem Entwurf
einen Beitrag zu machen passiert in der App, nicht über diese API — dort liegen
Freigabe, das sichtbare KI-Kennzeichen und der Zeitplan.
Reels gibt es nur hochkant (9:16). Eine Komposition ist Entwurfsmaterial, bis sie
durch den Veröffentlichungsweg von Ikrames gegangen ist.
Im Blick behalten, was du ausgibst
get_costs liest dieselben Ereignisse wie der Abrechnungsbildschirm. Nützlich vor und
nach einem Stapel, damit du siehst, was ein Lauf wirklich gekostet hat, statt es zu
schätzen.
Vorher lesen — get_costs mit dem Zeitfenster, das dich interessiert.
Die Arbeit machen. Jeder Aufruf, der Guthaben ausgibt, meldet cost_credits und
new_balance in seiner eigenen Antwort, du kannst also auch mittendrin aufhören.
Noch einmal lesen. Die Differenz ist, was der Lauf gekostet hat, aufgeschlüsselt nach dem, was ihn verursacht hat.
Eine gescheiterte Erzeugung wird nicht abgebucht
Lässt sich ein Auftrag nicht einreichen, kommt das Guthaben von selbst zurück, und der Aufruf meldet den Fehlschlag. Du zahlst für Arbeit, die stattgefunden hat, nicht für Arbeit, die versucht wurde.