Grok Imagine Image 2.0 ontvangt een scènebeschrijving en maakt een afbeelding. Het xAI-model kan ook met visueel bronmateriaal werken: veranderingen op basis van een tekstinstructie toepassen en de bewerking voortzetten met het vorige resultaat als nieuwe invoer. Ailoot publiceert een generatiemethode uit tekst.
Voor Image 2.0 beschrijft xAI realistische fotografie, anime, olieverfschilderkunst en potloodtekeningen. De stijl wordt in woorden opgegeven; bij een bronafbeelding bepaalt de instructie de gewenste esthetiek. Opeenvolgende wijzigingen voegen details toe en verfijnen het resultaat stap voor stap.
n bepaalt 1 tot 10 afbeeldingen voor één beschrijving; standaard één.aspect_ratio kiest de beeldvorm; auto laat de keuze aan het model.resolution stelt 1K of 2K in; de standaardwaarde is 1K.Vierkante, horizontale en verticale formaten zijn voorzien: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2. Langgerekte schermformaten 19.5:9, 9:19.5, 20:9 en 9:20 en brede formaten 21:9 en 5:2 zijn beschikbaar.
Image 2.0 ondersteunt low, medium en auto. De parameter hoort specifiek bij deze versie; auto wordt gebruikt als geen kwaliteit is opgegeven. Op de controledatum kiest de automatische modus low voor generatie en medium voor bewerking.
Volgens xAI gebruikt medium meer berekeningen voor een gedetailleerde uitwerking van de afbeelding. Expliciet kiezen van low of medium legt de gewenste modus vast, terwijl het gedrag van auto door de huidige fabrikantinstelling wordt bepaald.
Het model heeft tekstuele en visuele invoer en geeft afbeeldingen als resultaat. In de eigen bewerkingsmodus accepteert xAI Image 2.0 maximaal vijf bronafbeeldingen; de huidige Ailoot-generatiemethode gebruikt tekstinvoer. Het resultaat kan als bestand via een link of in base64 worden geleverd.
", "aboutText": "### Een afbeelding genereren en verfijnen\n\nGrok Imagine Image 2.0 ontvangt een scènebeschrijving en maakt een afbeelding. Het xAI-model kan ook met visueel bronmateriaal werken: veranderingen op basis van een tekstinstructie toepassen en de bewerking voortzetten met het vorige resultaat als nieuwe invoer. Ailoot publiceert een generatiemethode uit tekst.\n\n### Visuele stijlen\n\nVoor Image 2.0 beschrijft xAI realistische fotografie, anime, olieverfschilderkunst en potloodtekeningen. De stijl wordt in woorden opgegeven; bij een bronafbeelding bepaalt de instructie de gewenste esthetiek. Opeenvolgende wijzigingen voegen details toe en verfijnen het resultaat stap voor stap.\n\n### Verhoudingen, afmetingen en aantal\n\n- `n` bepaalt 1 tot 10 afbeeldingen voor één beschrijving; standaard één.\n- `aspect_ratio` kiest de beeldvorm; `auto` laat de keuze aan het model.\n- `resolution` stelt 1K of 2K in; de standaardwaarde is 1K.\n\nVierkante, horizontale en verticale formaten zijn voorzien: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `2:1`, `1:2`. Langgerekte schermformaten `19.5:9`, `9:19.5`, `20:9` en `9:20` en brede formaten `21:9` en `5:2` zijn beschikbaar.\n\n### Kwaliteit kiezen\n\nImage 2.0 ondersteunt `low`, `medium` en `auto`. De parameter hoort specifiek bij deze versie; `auto` wordt gebruikt als geen kwaliteit is opgegeven. Op de controledatum kiest de automatische modus `low` voor generatie en `medium` voor bewerking.\n\nVolgens xAI gebruikt `medium` meer berekeningen voor een gedetailleerde uitwerking van de afbeelding. Expliciet kiezen van `low` of `medium` legt de gewenste modus vast, terwijl het gedrag van `auto` door de huidige fabrikantinstelling wordt bepaald.\n\n### Invoer en resultaat\n\nHet model heeft tekstuele en visuele invoer en geeft afbeeldingen als resultaat. In de eigen bewerkingsmodus accepteert xAI Image 2.0 maximaal vijf bronafbeeldingen; de huidige Ailoot-generatiemethode gebruikt tekstinvoer. Het resultaat kan als bestand via een link of in base64 worden geleverd.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "879026b3fa16fe48db67e719f9b4282aad7c125f2be53fd61b1d0a9f3caccf02", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nl", "methods": [ { "html": "grok-imagine-image-2.0Grok Imagine Image 2.0 maakt afbeeldingen uit een beschrijving, met keuze van verhoudingen, resolutie en kwaliteit. Het model zelf ondersteunt ook beeldbewerking en overdracht van visuele stijl.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Grok Imagine Image 2.0 ontvangt een scènebeschrijving en maakt een afbeelding. Het xAI-model kan ook met visueel bronmateriaal werken: veranderingen op basis van een tekstinstructie toepassen en de bewerking voortzetten met het vorige resultaat als nieuwe invoer. Ailoot publiceert een generatiemethode uit tekst.
Voor Image 2.0 beschrijft xAI realistische fotografie, anime, olieverfschilderkunst en potloodtekeningen. De stijl wordt in woorden opgegeven; bij een bronafbeelding bepaalt de instructie de gewenste esthetiek. Opeenvolgende wijzigingen voegen details toe en verfijnen het resultaat stap voor stap.
n bepaalt 1 tot 10 afbeeldingen voor één beschrijving; standaard één.aspect_ratio kiest de beeldvorm; auto laat de keuze aan het model.resolution stelt 1K of 2K in; de standaardwaarde is 1K.Vierkante, horizontale en verticale formaten zijn voorzien: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2. Langgerekte schermformaten 19.5:9, 9:19.5, 20:9 en 9:20 en brede formaten 21:9 en 5:2 zijn beschikbaar.
Image 2.0 ondersteunt low, medium en auto. De parameter hoort specifiek bij deze versie; auto wordt gebruikt als geen kwaliteit is opgegeven. Op de controledatum kiest de automatische modus low voor generatie en medium voor bewerking.
Volgens xAI gebruikt medium meer berekeningen voor een gedetailleerde uitwerking van de afbeelding. Expliciet kiezen van low of medium legt de gewenste modus vast, terwijl het gedrag van auto door de huidige fabrikantinstelling wordt bepaald.
Het model heeft tekstuele en visuele invoer en geeft afbeeldingen als resultaat. In de eigen bewerkingsmodus accepteert xAI Image 2.0 maximaal vijf bronafbeeldingen; de huidige Ailoot-generatiemethode gebruikt tekstinvoer. Het resultaat kan als bestand via een link of in base64 worden geleverd.
POST /v1/images/generationstextimage| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten grok-imagine-image-2.0 | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten | Standaard— |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 Maximum: 10 | Standaard1 |
Veldresponse_format | Typestring | VereisteOptioneel | Waarden en limieten url, b64_json | Standaardurl |
Veldresolution | Typestring | VereisteOptioneel | Waarden en limieten 1k, 2k | Standaard1k |
Veldaspect_ratio | Typestring | VereisteOptioneel | Waarden en limieten 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 | Standaardauto |
Veldquality | Typestring | VereisteOptioneel | Waarden en limieten low, medium, auto | Standaard— |
Tekst naar afbeelding · Vereist: prompt
| Parameter | Contract |
|---|---|
Parametermaterial_types | Contracttext |
Parameterrequired | Contractmodel, prompt |
Parameteroptional_controls | Contractnull |
Parametercontent_type | Contractapplication/json |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · de daadwerkelijk geretourneerde task_id of het record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
De methodestructuren en ID’s zijn exact; de mogelijkheden van de leverancier staan los van toelating.
POST /v1/images/generationsAiloot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
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");\nDownload elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Sla elk data-item op. Decodeer elke b64_json of haal elk bestand op via elke geretourneerde ondertekende URL. Kies een bestandsextensie op basis van de daadwerkelijke MIME/bytes.
Als het resultaat van een afbeeldingsgeneratie of -bewerking moet worden gecontroleerd, bewaar dan de oorspronkelijke operation_id/X-Client-Request-ID en de geretourneerde resultaatinformatie. Haal bestaande eigen resultaten terug via de mediabibliotheek met de daadwerkelijke task_id- of asset_id-waarden. Dien de generatie-/bewerkingsaanvraag niet opnieuw in en bouw geen polling-URL op basis van operation_id.
| Veld | Type |
|---|---|
Veldcreated | Typeinteger |
Velddata[].url | Typestring |
Velddata[].b64_json | Typebase64 string |
Veldusage | Typeobject |
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig | Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag. |
Antwoordserver_error | VoorwaardeHet geretourneerde antwoord geeft aan dat de bewerking of het resultaat moet worden gecontroleerd | Volgende stapBewaar de oorspronkelijk geretourneerde bewerkings-/taak-ID, de aanvraagheaders en het antwoord; blijf de ondersteunde leesacties voor die oorspronkelijke bewerking uitvoeren. Dien de aanmaakaanvraag niet opnieuw in. |
Ailoot grok-imagine-image-2.0
Gebruik de hierboven getoonde methodepaden.