Grok Imagine Image 2.0 erhält eine Szenenbeschreibung und erstellt ein Bild. Das xAI-Modell kann auch mit visuellen Ausgangsmaterialien arbeiten: Änderungen nach Textanweisungen anwenden und die Bearbeitung fortsetzen, indem das vorherige Ergebnis als neue Eingabe dient. Bei Ailoot ist eine Textgenerierungsmethode veröffentlicht.
Für Image 2.0 beschreibt xAI realistische Fotografie, Anime, Ölmalerei und Bleistiftzeichnung. Der Stil wird sprachlich festgelegt; bei Ausgangsbildern bestimmt die Anweisung die gewünschte Ästhetik. Aufeinanderfolgende Änderungen erlauben es, Details hinzuzufügen und das Ergebnis schrittweise zu präzisieren.
n legt 1 bis 10 Bilder pro Beschreibung fest; standardmässig eines.aspect_ratio wählt die Bildform; auto überlässt die Auswahl dem Modell.resolution legt 1K oder 2K fest; der Standardwert ist 1K.Vorgesehen sind quadratische, horizontale und vertikale Formate: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2. Verfügbar sind langgestreckte Bildschirmformate 19.5:9, 9:19.5, 20:9, 9:20 sowie breite 21:9 und 5:2.
Image 2.0 unterstützt low, medium und auto. Dieser Parameter gehört genau zu dieser Version; auto wird verwendet, wenn keine Qualität angegeben ist. Zum Prüfzeitpunkt wählt der automatische Modus low bei Generierung und medium bei Bearbeitung.
Laut xAI weist medium mehr Rechenaufwand für detaillierte Bildausarbeitung zu. Eine ausdrückliche Wahl von low oder medium legt den gewünschten Modus fest; das Verhalten von auto wird durch die aktuelle Herstellereinstellung bestimmt.
Das Modell hat textuelle und visuelle Eingabe; das Ergebnis sind Bilder. Im eigenen xAI-Bearbeitungsmodus nimmt Image 2.0 bis zu fünf Ausgangsbilder entgegen; die aktuelle Ailoot-Generierungsmethode verwendet Texteingabe. Das Ergebnis kann als verlinkte Datei oder in base64 übermittelt werden.
", "aboutText": "### Bildgenerierung und Verfeinerung\n\nGrok Imagine Image 2.0 erhält eine Szenenbeschreibung und erstellt ein Bild. Das xAI-Modell kann auch mit visuellen Ausgangsmaterialien arbeiten: Änderungen nach Textanweisungen anwenden und die Bearbeitung fortsetzen, indem das vorherige Ergebnis als neue Eingabe dient. Bei Ailoot ist eine Textgenerierungsmethode veröffentlicht.\n\n### Visuelle Stile\n\nFür Image 2.0 beschreibt xAI realistische Fotografie, Anime, Ölmalerei und Bleistiftzeichnung. Der Stil wird sprachlich festgelegt; bei Ausgangsbildern bestimmt die Anweisung die gewünschte Ästhetik. Aufeinanderfolgende Änderungen erlauben es, Details hinzuzufügen und das Ergebnis schrittweise zu präzisieren.\n\n### Seitenverhältnisse, Grösse und Anzahl\n\n- `n` legt 1 bis 10 Bilder pro Beschreibung fest; standardmässig eines.\n- `aspect_ratio` wählt die Bildform; `auto` überlässt die Auswahl dem Modell.\n- `resolution` legt 1K oder 2K fest; der Standardwert ist 1K.\n\nVorgesehen sind quadratische, horizontale und vertikale Formate: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `2:1`, `1:2`. Verfügbar sind langgestreckte Bildschirmformate `19.5:9`, `9:19.5`, `20:9`, `9:20` sowie breite `21:9` und `5:2`.\n\n### Qualitätswahl\n\nImage 2.0 unterstützt `low`, `medium` und `auto`. Dieser Parameter gehört genau zu dieser Version; `auto` wird verwendet, wenn keine Qualität angegeben ist. Zum Prüfzeitpunkt wählt der automatische Modus `low` bei Generierung und `medium` bei Bearbeitung.\n\nLaut xAI weist `medium` mehr Rechenaufwand für detaillierte Bildausarbeitung zu. Eine ausdrückliche Wahl von `low` oder `medium` legt den gewünschten Modus fest; das Verhalten von `auto` wird durch die aktuelle Herstellereinstellung bestimmt.\n\n### Eingabe und Ergebnis\n\nDas Modell hat textuelle und visuelle Eingabe; das Ergebnis sind Bilder. Im eigenen xAI-Bearbeitungsmodus nimmt Image 2.0 bis zu fünf Ausgangsbilder entgegen; die aktuelle Ailoot-Generierungsmethode verwendet Texteingabe. Das Ergebnis kann als verlinkte Datei oder in base64 übermittelt werden.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "bea2a2be713d378acbd7598ecdd9b65e66c68d9c22427f01bcc0133751341af8", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "de-ch", "methods": [ { "html": "grok-imagine-image-2.0Grok Imagine Image 2.0 erstellt Bilder anhand von Beschreibungen mit auswählbaren Seitenverhältnissen, Auflösung und Qualität. Das Modell selbst unterstützt auch Bildbearbeitung und die Übertragung visueller Stile.
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Grok Imagine Image 2.0 erhält eine Szenenbeschreibung und erstellt ein Bild. Das xAI-Modell kann auch mit visuellen Ausgangsmaterialien arbeiten: Änderungen nach Textanweisungen anwenden und die Bearbeitung fortsetzen, indem das vorherige Ergebnis als neue Eingabe dient. Bei Ailoot ist eine Textgenerierungsmethode veröffentlicht.
Für Image 2.0 beschreibt xAI realistische Fotografie, Anime, Ölmalerei und Bleistiftzeichnung. Der Stil wird sprachlich festgelegt; bei Ausgangsbildern bestimmt die Anweisung die gewünschte Ästhetik. Aufeinanderfolgende Änderungen erlauben es, Details hinzuzufügen und das Ergebnis schrittweise zu präzisieren.
n legt 1 bis 10 Bilder pro Beschreibung fest; standardmässig eines.aspect_ratio wählt die Bildform; auto überlässt die Auswahl dem Modell.resolution legt 1K oder 2K fest; der Standardwert ist 1K.Vorgesehen sind quadratische, horizontale und vertikale Formate: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2. Verfügbar sind langgestreckte Bildschirmformate 19.5:9, 9:19.5, 20:9, 9:20 sowie breite 21:9 und 5:2.
Image 2.0 unterstützt low, medium und auto. Dieser Parameter gehört genau zu dieser Version; auto wird verwendet, wenn keine Qualität angegeben ist. Zum Prüfzeitpunkt wählt der automatische Modus low bei Generierung und medium bei Bearbeitung.
Laut xAI weist medium mehr Rechenaufwand für detaillierte Bildausarbeitung zu. Eine ausdrückliche Wahl von low oder medium legt den gewünschten Modus fest; das Verhalten von auto wird durch die aktuelle Herstellereinstellung bestimmt.
Das Modell hat textuelle und visuelle Eingabe; das Ergebnis sind Bilder. Im eigenen xAI-Bearbeitungsmodus nimmt Image 2.0 bis zu fünf Ausgangsbilder entgegen; die aktuelle Ailoot-Generierungsmethode verwendet Texteingabe. Das Ergebnis kann als verlinkte Datei oder in base64 übermittelt werden.
POST /v1/images/generationstextimage| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits grok-imagine-image-2.0 | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits | Standard— |
Feldn | Typinteger | AnforderungOptional | Werte und Limits Minimum: 1 Maximum: 10 | Standard1 |
Feldresponse_format | Typstring | AnforderungOptional | Werte und Limits url, b64_json | Standardurl |
Feldresolution | Typstring | AnforderungOptional | Werte und Limits 1k, 2k | Standard1k |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20, 21:9, 5:2 | Standardauto |
Feldquality | Typstring | AnforderungOptional | Werte und Limits low, medium, auto | Standard— |
Text zu Bild · Erforderlich: prompt
| Parameter | Vertrag |
|---|---|
Parametermaterial_types | Vertragtext |
Parameterrequired | Vertragmodel, prompt |
Parameteroptional_controls | Vertragnull |
Parametercontent_type | Vertragapplication/json |
Lebenszyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · die tatsächlich zurückgegebene task_id oder ein Eintrag in der Medienbibliothek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Methodenstrukturen und IDs sind exakt; die Fähigkeiten des Anbieters sind von der Zulassung einer Anfrage zu unterscheiden.
POST /v1/images/generationsAiloot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "grok-imagine-image-2.0", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nfrom openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'grok-imagine-image-2.0', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "grok-imagine-image-2.0", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\nLaden Sie jedes zurückgegebene Bild herunter oder speichern Sie seinen Base64-Inhalt
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Speichern Sie jedes fertiggestellte Bild; rufen Sie jede zurückgegebene URL ab oder dekodieren Sie seinen Base64-Inhalt.
Jedes Datenelement speichern. Jedes b64_json dekodieren oder jede zurückgegebene signierte URL abrufen. Die Dateiendung anhand des tatsächlichen MIME-Typs bzw. der Bytes wählen.
Wenn das Ergebnis einer Bildgenerierung oder -bearbeitung geprüft werden muss, die ursprüngliche operation_id/X-Client-Request-ID und die zurückgegebenen Ergebnisinformationen aufbewahren. Bereits vorhandene eigene Ergebnisse über die Medienbibliothek anhand tatsächlicher task_id- oder asset_id-Werte wiederherstellen. Die Generierungs-/Bearbeitungsanfrage nicht erneut senden und keine Abfrage-URL aus operation_id bilden.
| Feld | Typ |
|---|---|
Feldcreated | Typinteger |
Felddata[].url | Typstring |
Felddata[].b64_json | Typbase64 string |
Feldusage | Typobject |
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungPflichtfelder, Darstellung des Eingabematerials oder Parameterwert ungültig | Nächster SchrittDie angegebenen Felder vor einer neuen Erstellungsanfrage korrigieren. |
Antwortserver_error | BedingungDie zurückgegebene Antwort gibt an, dass der Vorgang oder das Ergebnis eine Prüfung erfordert | Nächster SchrittDie ursprünglich zurückgegebene Vorgangs-/Aufgaben-ID, die Anfrageheader und die Antwort aufbewahren; mit unterstützten Leseaufrufen für diesen ursprünglichen Vorgang fortfahren. Die Erstellungsanfrage nicht erneut senden. |
Ailoot grok-imagine-image-2.0
Verwenden Sie die oben angezeigten Methodenpfade.