aisplice

Nach Fähigkeit

Bilder

Modell wählen, Anfrage kopieren, Bild erhalten. Alles Weitere unten richtet sich nach dem gewählten Modell.

#1. Modell wählen

#3. Ergebnis abrufen

Der Einreichungsaufruf antwortet sofort mit einer task_id. Fragen Sie den Task alle paar Sekunden ab, bis status completed ist, oder übergeben Sie webhook_url, dann benachrichtigen wir Sie, sobald er fertig ist.

GET https://www.aisplice.store/v1/images/tasks/{task_id}

GET https://www.aisplice.store/v1/images/tasks/{task_id}/content

Nur bei Erfolg berechnet

Ein fehlgeschlagener oder abgebrochener Task wird automatisch erstattet. Das Anfrageprotokoll zeigt die endgültigen Kosten jedes Tasks.

Statuswerte und Abfragen →Callback statt Abfragen →

#Wenn etwas schiefgeht

  • 400 mit einem Feldnamen: Diese Option akzeptiert das Modell nicht; verwenden Sie die Werte aus Schritt 2.
  • Inhalt vom Modell abgelehnt: Formulieren Sie den Prompt um; abgelehnte Anfragen werden nicht berechnet.
  • 402: Das Guthaben deckt diese Anfrage nicht; laden Sie im Wallet auf und versuchen Sie es dann erneut.
  • 429: Langsamer werden und nach Retry-After Sekunden erneut versuchen.
  • 503 model_not_found: Der Modellname ist falsch oder das Modell ist offline; wählen Sie eines aus Schritt 1.

Andere Fehler nachschlagen →

#Referenzbilder

Übergeben Sie öffentliche Bild-URLs im Referenzbild-Feld aus Schritt 2. Eine lokale Datei laden Sie zuerst hoch und verwenden dann die erhaltene URL.

So laden Sie eine lokale Datei hoch →

In Ihr Produkt einbauenWelche Optionen Sie Ihren Nutzern zuerst zeigen und welche Sie für später aufheben.
Welche Optionen Sie Ihren Nutzern zuerst zeigenBeginnen Sie mit dem Prompt und einer Preis-Stellschraube; ergänzen Sie den Rest, sobald der Basisablauf funktioniert.+

Kreative Absicht

Felder wie prompt gehören in die UI, weil Nutzer das Ergebnis, das sie damit verändern, direkt verstehen.

Kostenmultiplikator

Felder wie duration, resolution, size und count sollten erst eingeführt werden, wenn sich die Preise bereits nachvollziehbar erklären lassen.

Moduswechsel

Felder wie image, mask oder Fortsetzungs-IDs verändern den Ablauf selbst und sollten nur in eigenen Modi erscheinen.

Systeminterna

Felder wie webhook_secret sind für Integratoren gedacht, nicht für alltägliche Creator, und gehören daher nicht in die Standard-UI.

  • prompt
    Anzeigen, wenn
    Immer. Es ist die wichtigste kreative Eingabe für Bild-Tasks.
    Empfohlener Standard
    In der UI erforderlich.
    Warum es wichtig ist
    Es steuert das Ergebnis direkt; ohne es ist die Funktion unbrauchbar.
  • size
    Anzeigen, wenn
    Schon in der ersten Version anzeigen, wenn sich die Abrechnung nach den Ausgabeabmessungen richtet.
    Empfohlener Standard
    Mit einem empfohlenen Seitenverhältnis wie 1:1 beginnen.
    Warum es wichtig ist
    Es beeinflusst sowohl die Kosten als auch die Bildkomposition, daher brauchen Nutzer früh eine einfache Größenwahl.
  • quality
    Anzeigen, wenn
    Erst anzeigen, wenn Nutzer ausdrücklich eine höhere oder günstigere Stufe wünschen.
    Empfohlener Standard
    Serverseitig beim Modellstandard belassen.
    Warum es wichtig ist
    Es ändert Preis und Latenz, muss aber meist nicht ab dem ersten Tag einstellbar sein.
  • n
    Anzeigen, wenn
    Nur anzeigen, wenn Batch-Generierung ein zentraler Workflow ist.
    Empfohlener Standard
    Standardmäßig 1.
    Warum es wichtig ist
    Es vervielfacht die Kosten sofort und kann den ersten Eindruck unübersichtlich machen.
  • mask / image
    Anzeigen, wenn
    Nur bei Bearbeitungs- oder Referenzbild-Produkten anzeigen.
    Empfohlener Standard
    Im Text-zu-Bild-Modus ausblenden.
    Warum es wichtig ist
    Diese Felder machen aus Generierung Bearbeitung und sollten daher nicht in den Basisablauf geraten.
recommended-rollout.txt
Phase 1
- prompt
- one size or one duration default
- submit -> poll -> content

Phase 2
- one quality or resolution selector
- clear pricing hint

Phase 3
- advanced controls such as reference media, continuation, webhook, or vendor-specific tuning

Eine einzige Quelle für Ergebnisse

Wenn ein Task fertig ist, richten Sie Ihre App auf die Plattform-URL aus, die /content zurückgibt. So bleiben Details des Upstream-Anbieters verborgen und die Wiedergabe älterer Ergebnisse stabil.

Immer noch nicht gelöst?

Senden Sie uns die Anfrage-ID oder die Fehlermeldung, und wir sehen uns das an.

ZurückChatWeiterVideos