Grok Imagine API: Bilder mit dem Pipe2 SDK erzeugen

Für den Zugriff auf die Grok Imagine API über Pipe2 startest du Image Generator mit model: 'grok-imagine-image'. Sende einen Textprompt, frage den Status über die zurückgegebene Lauf-ID ab und rufe das erzeugte Bild ab. Diese Anleitung verwendet die API und Authentifizierung von Pipe2; sie zeigt keinen direkten Aufruf der xAI API.

Grok ausdrücklich auswählen

Der Pipeline-Slug lautet image-generator; die Modellkennung steht in input. Nutze grok-imagine-image für das Standardmodell oder grok-imagine-image-quality für Grok Imagine Quality. Auto kann eine andere Engine wählen. Lege das Modell deshalb fest, wenn Grok erforderlich ist.

Das Beispiel verwendet das Standardmodell, keine Referenzbilder und quality: 'fast': eine gültige Grok-Konfiguration mit den niedrigsten Kosten für diesen Ablauf. Fast wählt eine 1K-Ausgabe, auto und hd wählen 2K. Beim Standardmodell kostet das Bild derzeit in beiden Größen gleich viel; fast bietet keinen zusätzlichen Preisnachlass. Referenzbilder verursachen zusätzliche Kosten. Nutze vor einer größeren Verarbeitung EstimatePipelineCost mit demselben Slug und denselben Eingaben.

Das SDK-Beispiel ausführen

Installiere das Paket mit npm install @pipe2-ai/sdk. Speichere den folgenden Code als grok-image.mjs, hinterlege ein persönliches Pipe2-Zugriffstoken in der Umgebungsvariablen PIPE2_TOKEN und starte node grok-image.mjs. Dein Konto benötigt ausreichend Credits. Bewahre das Token auf dem Server auf.

import { createClient } from '@pipe2-ai/sdk';

const token = process.env.PIPE2_TOKEN;
if (!token) throw new Error('Set PIPE2_TOKEN');
const client = createClient(token);
const input = {
  model: 'grok-imagine-image',
  prompt: 'A small red paper boat on a rain-darkened stone step, soft morning light, editorial photograph, no text.',
  quality: 'fast',
  enhance_prompt: false,
};
const { run_pipeline } = await client.RunPipeline({
  pipeline_slug: 'image-generator',
  input,
});

for (let attempt = 0; attempt < 60; attempt++) {
  const { pipeline_runs_by_pk: run } = await client.GetPipelineRun({
    id: run_pipeline.run_id,
  });
  if (!run) throw new Error('Run not found');
  if (run.status === 'failed' || run.status === 'cancelled') {
    throw new Error(run.error_message ?? run.status);
  }
  if (run.status === 'completed') {
    const url = run.assets?.[0]?.url;
    if (!url) throw new Error('Completed run has no image asset');
    console.log(url);
    process.exit(0);
  }
  await new Promise((resolve) => setTimeout(resolve, 3000));
}
throw new Error(`Polling timed out; resume with run ID ${run_pipeline.run_id}`);

Die zugehörige Pipeline-Anfrage lautet:

{
  "pipeline_slug": "image-generator",
  "input": {
    "model": "grok-imagine-image",
    "prompt": "A small red paper boat on a rain-darkened stone step, soft morning light, editorial photograph, no text.",
    "quality": "fast",
    "enhance_prompt": false
  }
}

Die Dokumentation zum TypeScript SDK beschreibt den Client dieses JavaScript-Moduls. Die API-Referenz erläutert die öffentliche API.

Die Lauf-ID behalten, bis das Bild fertig ist

RunPipeline liefert eine Lauf-ID, nicht das fertige Bild. GetPipelineRun ruft Status und Ausgabedateien ab. Das Beispiel bricht bei einem Fehler oder einer Stornierung ab, prüft bei einem abgeschlossenen Lauf, ob eine Datei vorhanden ist, und gibt die erste Bild-URL aus. Es begrenzt die Abfrage auf 60 Prüfungen mit jeweils drei Sekunden Wartezeit. Das ist eine Entscheidung der Anwendung und keine Zusage zur Generierungsdauer.

Nach einer Zeitüberschreitung fragst du dieselbe Lauf-ID erneut ab, statt eine doppelte Generierung zu starten. Speichere die ID sofort nach erfolgreichem Start. Behandle im Produktivbetrieb auch Netzwerkfehler und bewahre die Referenz auf die Ausgabedatei dort auf, wo deine Anwendung sie benötigt.

Referenzen nur bei Bedarf hinzufügen

Ein Textprompt genügt. Beide Grok-Bildmodelle unterstützen bis zu drei JPEG- oder PNG-Dateien in reference_images, mit höchstens 20 MB pro Bild. reference_videos werden in dieser Pipeline nicht unterstützt. Zur Auswahl stehen 1:1, 16:9, 9:16, 4:3 und 3:4; das Beispiel nutzt das quadratische Standardformat.

enhance_prompt: false verhindert bei einer reinen Textanfrage, dass der Prompt vor der Generierung umgeschrieben wird. Beschreibe Motiv, Umgebung, Bildausschnitt und Licht und prüfe das Ergebnis vor der Verwendung. Für gezielte Kompositionen hilft die Grok-Imagine-Prompt-Anleitung. Erkläre beim Hinzufügen von Referenzen den Beitrag jedes Bildes und schätze die Kosten der geänderten Anfrage erneut.