Source: https://ailoot.ai/models/el/qwen-image-3-0-pro/
Canonical: https://ailoot.ai/models/el/qwen-image-3-0-pro/
Language: el

# qwen-image-3.0-pro

[Markdown](https://ailoot.ai/models/el/qwen-image-3-0-pro/index.md) · [JSON](https://ailoot.ai/models/el/qwen-image-3-0-pro/facts.json)

## [qwen-image-3.0-pro](https://ailoot.ai/models/el/qwen-image-3-0-pro/)

Μοντέλο δημιουργίας εικόνων από κείμενο, με έμφαση σε σύνθετες μακέτες, επιγραφές και ρεαλιστικές λεπτομέρειες. Είναι κατάλληλο για αφίσες, εικονογραφημένα σενάρια, μενού και υλικό με πυκνή σύνθεση.

- [**Ailoot · Εικόνες** `POST /v1/images/generations` `qwen-image-3.0-pro`](https://ailoot.ai/models/el/qwen-image-3-0-pro/#method-0)
- [**Ailoot · Εικόνες** `POST /v1/images/generations` `qwen-image`](https://ailoot.ai/models/el/qwen-image-3-0-pro/#method-1)
- [**Ailoot · Εικόνες** `POST /v1/images/generations` `qwen-image-latest`](https://ailoot.ai/models/el/qwen-image-3-0-pro/#method-2)

Σχετικά με το μοντέλο

Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.

Το Qwen-Image-3.0-Pro είναι μοντέλο της Alibaba για τη δημιουργία και την επεξεργασία εικόνων όπου έχουν σημασία η σύνθεση, οι επιγραφές και οι μικρές λεπτομέρειες. Στις χρήσεις του περιλαμβάνονται πυκνές μακέτες, εικόνες μέσα σε εικόνες, σελιδοποίηση εφημερίδων, εικονογραφημένα σενάρια, μενού και εκπαιδευτικά φύλλα. Η τρέχουσα κάρτα του Ailoot παρουσιάζει τη λειτουργία δημιουργίας εικόνας από οδηγίες κειμένου. Η Alibaba προβλέπει επίσης επεξεργασία και εργασία με εικόνες αναφοράς· αυτές οι ενέργειες απαιτούν ξεχωριστή υποστήριξη εικόνων εισόδου και δεν περιλαμβάνονται στην τρέχουσα μέθοδο της κάρτας.

#### Κείμενο και λεπτομέρειες στην εικόνα

Ο κατασκευαστής δίνει έμφαση σε μεγάλες οδηγίες έως 4,5 χιλ. token, επιγραφές σε 12 γλώσσες και χρήση πολλών γραμματοσειρών. Πρόκειται για περιγραφόμενη δυνατότητα επεξεργασίας οδηγιών, όχι για δημοσιευμένο μέγεθος ονομαστικού παραθύρου συμφραζομένων. Στα χαρακτηριστικά που αναφέρει περιλαμβάνονται η απόδοση μικρών επιγραφών μεγέθους 10 pixel, της υφής του δέρματος και των μαλλιών, καθώς και μικρών αλλαγών στην έκφραση του προσώπου. Αυτές οι λεπτομέρειες είναι χρήσιμες για υλικό που εξετάζεται από κοντά.

Το Qwen-Image-3.0-Pro προορίζεται επίσης για οπτικές ιδέες ιστοσελίδων, παιχνιδιών και οθονών ζωντανών μεταδόσεων. Ένα τέτοιο αποτέλεσμα μπορεί να συνδυάζει εικονογράφηση, δομή οθόνης και μορφοποιημένες επιγραφές. Το μοντέλο δημιουργεί εικόνα της μακέτας· μια λειτουργική εφαρμογή χρειάζεται ξεχωριστή υλοποίηση.

#### Επεξεργασία στις προδιαγραφές της Alibaba

Για τη λειτουργία επεξεργασίας, η Alibaba αναφέρει από μία έως τρεις εικόνες. Σε αυτόν τον τρόπο χρήσης, ο κατασκευαστής επιτρέπει τη σύνδεση ενός αντικειμένου με τον αριθμό της εικόνας αναφοράς και την περιγραφή του συνδυασμού των υλικών. Προβλέπονται προσθήκη, αφαίρεση και μετακίνηση αντικειμένων, αλλαγή της δράσης, του ύφους, των λεπτομερειών και του κειμένου. Μια αρνητική περιγραφή βοηθά να δηλωθούν τα ανεπιθύμητα στοιχεία.

Στην υλοποίηση επεξεργασίας του κατασκευαστή γίνονται δεκτά αρχεία JPG, JPEG, PNG, BMP, TIFF, WEBP και GIF. Για κινούμενο GIF χρησιμοποιείται το πρώτο καρέ. Κάθε αρχείο μπορεί να έχει μέγεθος έως 10 MB· ο κατασκευαστής συνιστά εικόνες με πλευρές από 384 έως 3072 pixel. Αυτές είναι συστάσεις για την είσοδο και όχι διαστάσεις του τελικού αποτελέσματος.

Στις προδιαγραφές του κατασκευαστή προβλέπονται από μία έως έξι εικόνες εξόδου σε PNG ανά αίτημα. Το εύρος της επιφάνειας του αποτελέσματος είναι από 262 144 έως 4 194 304 pixel, που αντιστοιχεί σε τετράγωνες εικόνες από 512 × 512 έως 2048 × 2048. Επιτρέπονται λόγοι διαστάσεων από 1:8 έως 8:1, οπότε για επιμήκεις συνθέσεις το μήκος της πλευράς εξαρτάται και από το επιλεγμένο σχήμα του καρέ. Προβλέπεται πρόσθετη επεξεργασία των οδηγιών πριν από τη δημιουργία.

**Ailoot · Εικόνες** `POST /v1/images/generations` `qwen-image-3.0-pro`

[`qwen-image-3.0-pro`](https://ailoot.ai/models/el/#m=qwen-image-3.0-pro&route=Core&caller=qwen-image-3.0-pro&fmt=images)

Alibaba /`qwen-image-3.0-pro`

ID μοντέλου

- `qwen-image-3.0-pro`
- `qwen-image`
- `qwen-image-latest`

### Εισαγωγή

Μοντέλο δημιουργίας εικόνων από κείμενο, με έμφαση σε σύνθετες μακέτες, επιγραφές και ρεαλιστικές λεπτομέρειες. Είναι κατάλληλο για αφίσες, εικονογραφημένα σενάρια, μενού και υλικό με πυκνή σύνθεση.

Αποδεκτές είσοδοι

Κείμενο

Αποτελέσματα

Εικόνες

### Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι

**Ailoot · Εικόνες** `POST /v1/images/generations`

Είσοδος

`text`

Έξοδος

`image`

Μορφή εξόδου

Αρχείο εικόνας

| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
| --- | --- | --- | --- | --- |
| Πεδίο`model` | Τύπος`string` | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια qwen-image-3.0-pro | Προεπιλογή— |
| Πεδίο`prompt` | Τύπος`string` | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο μήκος: 1 | Προεπιλογή— |
| Πεδίο`n` | Τύπος`integer` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 | Προεπιλογή1 |
| Πεδίο`response_format` | Τύπος`string` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια url, b64\_json | Προεπιλογή— |
| Πεδίο`stream` | Τύπος`boolean` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογήfalse |
| Πεδίο`size` | Τύπος`string` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
| Πεδίο`partial_images` | Τύπος`integer` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
| Πεδίο`images[].image_url` | Τύπος`string` | ΑπαίτησηΔεν υποστηρίζεται | Τιμές και όρια Μέγιστο πλήθος αποκωδικοποιημένων byte: 10.485.760 Τύποι MIME: image/png, image/jpeg Μέγιστο πλήθος εικόνων ανά πίνακα: 3 Συνθήκες: Ένα πραγματικό URL ανά αντικείμενο images\[\]. Το πλήθος του πίνακα διαφέρει από αυτή την τελική τιμή συμβολοσειράς. Εφαρμόζεται όταν: Μόνο JSON images/edits· το JSON images/generations δεν αναλύει αναφορές images. | Προεπιλογή— |
| Πεδίο`image` | Τύπος`file` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Μέγιστο πλήθος αποκωδικοποιημένων byte: 10.485.760 Τύποι MIME: image/png, image/jpeg Εφαρμόζεται όταν: δημιουργία με multipart/form-data | Προεπιλογή— |
| Πεδίο`image[]` | Τύπος`file[]` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Μέγιστο πλήθος στοιχείων: 3 Μέγιστο πλήθος αποκωδικοποιημένων byte: 10.485.760 Τύποι MIME: image/png, image/jpeg Εφαρμόζεται όταν: δημιουργία με multipart/form-data | Προεπιλογή— |

Συνδυασμοί υλικών εισόδου

**Κείμενο σε εικόνα** · Υποχρεωτικό: prompt

**reference\_images\_generation** · Υποχρεωτικό: prompt

Παράμετροι και κύκλος ζωής μεθόδου

| Παράμετρος | Σύμβαση |
| --- | --- |
| Παράμετρος`material_types` | Σύμβασηtext |
| Παράμετρος`required` | Σύμβασηmodel, prompt |
| Παράμετρος`optional_controls` | Σύμβασηnull |
| Παράμετρος`content_type` | Σύμβασηapplication/json |

Κύκλος ζωής: `synchronous_result_then_owned_library`

`GET /v1/media/tasks/{task_id}` · Το πραγματικό task\_id που επιστράφηκε ή μια εγγραφή στη βιβλιοθήκη πολυμέσων

`GET /v1/media/assets/{asset_id}/content`

`GET /v1/media/assets`

`GET /v1/media/assets/{asset_id}`

Οι δομές και τα ID των μεθόδων είναι ακριβή· η δυνατότητα του προμηθευτή είναι ξεχωριστή από την αποδοχή αιτημάτων.

### Τιμολόγηση

#### Χρεώσεις μεθόδων Ailoot

Είσοδος

0,003 $ *ανά εικόνα εισόδου*

Έξοδος

0,04 $ *ανά εικόνα ανάλυσης 1K*

Έξοδος

0,075 $ *ανά εικόνα ανάλυσης 2K*

Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. [Πώς λειτουργούν η δέσμευση και η εκκαθάριση →](https://ailoot.ai/docs/el/billing/reserve/)

### Παραδείγματα αιτημάτων

#### Ailoot · Εικόνες

curlPython SDKNode.js SDK

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
export AILOOT_API_KEY
: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"
export AILOOT_PROMPT_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "qwen-image-3.0-pro", "prompt": ""}')
f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")
p['prompt']=f.read_text(encoding="utf-8")
if not p['prompt'].strip():raise SystemExit("Brief must contain text")
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        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"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
```

```python
from openai import OpenAI
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        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"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")

f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")
request={'model': 'qwen-image-3.0-pro', 'prompt': ''}
request["prompt"]=f.read_text(encoding="utf-8")
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.images.generate(**request)
Path("sdk-result.txt").write_text(str(result),encoding="utf-8")
save_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])
```

```js
import OpenAI from "openai";
import { readFileSync, writeFileSync } from "node:fs";
const key=process.env.AILOOT_API_KEY;
if(!key) throw new Error("Set your actual Ailoot API key");
const client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});
const request={"model": "qwen-image-3.0-pro", "prompt": ""};
if(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");
request.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");
const result=await client.images.generate(request);
writeFileSync("sdk-result.json",JSON.stringify(result,null,2));
if(!result.data?.length) throw new Error("No completed images");
for(let index=0;index<result.data.length;index++) {
  const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;
  if(!encoded && uri.startsWith("data:image/")) {
    const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");
    encoded=uri.slice(comma+1);
  }
  if(encoded) {
    if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");
    raw=Buffer.from(encoded,"base64");
  } else if(uri) {
    const u=new URL(uri,"https://api.ailoot.ai");
    if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");
    const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");
    const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});
    if(!response.ok) throw new Error("Image content download failed: "+response.status);
    raw=Buffer.from(await response.arrayBuffer());
  } else throw new Error("Image has neither bytes nor URL");
  if(!raw.length) throw new Error("Empty image result");
  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";
  writeFileSync(`image-${index}.${ext}`,raw);
}
console.log("Every returned image saved; sdk-result.json retains complete metadata");
```

### Λήψη και αποθήκευση αποτελεσμάτων

#### Ailoot · Εικόνες

Κατεβάστε κάθε εικόνα που επιστρέφεται ή αποθηκεύστε το περιεχόμενο Base64

- `GET /v1/media/tasks/{task_id}`
- `GET /v1/media/assets/{asset_id}/content`
- `GET /v1/media/assets`
- `GET /v1/media/assets/{asset_id}`

##### Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα

Αποθηκεύστε κάθε ολοκληρωμένη εικόνα· ανακτήστε κάθε URL που επιστρέφεται ή αποκωδικοποιήστε το περιεχόμενο Base64.

Αποθηκεύστε κάθε στοιχείο δεδομένων. Αποκωδικοποιήστε κάθε b64\_json ή ανακτήστε κάθε υπογεγραμμένο URL που επιστράφηκε. Επιλέξτε την επέκταση του ονόματος αρχείου βάσει του πραγματικού τύπου MIME/των byte.

##### Αν χρειάζεται έλεγχος της αρχικής απάντησης

Αν το αποτέλεσμα παραγωγής ή επεξεργασίας εικόνας χρειάζεται έλεγχο, διατηρήστε το αρχικό operation\_id/X-Client-Request-ID και τις πληροφορίες αποτελέσματος που επιστράφηκαν. Ανακτήστε τα υπάρχοντα αποτελέσματα που σας ανήκουν μέσω της βιβλιοθήκης πολυμέσων χρησιμοποιώντας πραγματικές τιμές task\_id ή asset\_id. Μην υποβάλετε ξανά το αίτημα παραγωγής/επεξεργασίας και μην κατασκευάσετε URL περιοδικού ελέγχου από το operation\_id.

Πεδία απάντησης

| Πεδίο | Τύπος |
| --- | --- |
| Πεδίο`created` | Τύποςinteger |
| Πεδίο`data[].url` | Τύποςstring |
| Πεδίο`data[].b64_json` | Τύποςbase64 string |
| Πεδίο`usage` | Τύποςobject |

Σφάλματα και επόμενα βήματα

| Απάντηση | Συνθήκη | Επόμενο βήμα |
| --- | --- | --- |
| Απάντηση400 · `invalid_request_error` | ΣυνθήκηΜη έγκυρα υποχρεωτικά πεδία, μη έγκυρη αναπαράσταση υλικού ή μη έγκυρη τιμή παραμέτρου | Επόμενο βήμαΔιορθώστε τα υποδεικνυόμενα πεδία πριν από νέο αίτημα δημιουργίας. |
| Απάντηση`server_error` | ΣυνθήκηΗ απόκριση που επιστράφηκε αναφέρει ότι η λειτουργία ή το αποτέλεσμα χρειάζεται έλεγχο | Επόμενο βήμαΔιατηρήστε το αρχικό ID της λειτουργίας/εργασίας που επιστράφηκε, τις κεφαλίδες του αιτήματος και την απόκριση· συνεχίστε με τις υποστηριζόμενες αναγνώσεις αυτής της αρχικής λειτουργίας. Μην υποβάλετε ξανά το αίτημα δημιουργίας. |

### Εναλλακτικά ονόματα

#### Εναλλακτικά ονόματα μοντέλου

**Ailoot** [`qwen-image-3.0-pro`](https://ailoot.ai/models/el/#m=qwen-image-3.0-pro&route=Core&caller=qwen-image-3.0-pro&fmt=images), [`qwen-image`](https://ailoot.ai/models/el/#m=qwen-image-3.0-pro&route=Core&caller=qwen-image&fmt=images), [`qwen-image-latest`](https://ailoot.ai/models/el/#m=qwen-image-3.0-pro&route=Core&caller=qwen-image-latest&fmt=images)

#### Εναλλακτικές διαδρομές μεθόδων

Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.

#### Σχετικά ID μοντέλων

[`qwen-image-3.0-pro`](https://ailoot.ai/models/el/#m=qwen-image-3.0-pro&route=Core&caller=qwen-image-3.0-pro&fmt=images), [`qwen-image`](https://ailoot.ai/models/el/#m=qwen-image-3.0-pro&route=Core&caller=qwen-image&fmt=images), [`qwen-image-latest`](https://ailoot.ai/models/el/#m=qwen-image-3.0-pro&route=Core&caller=qwen-image-latest&fmt=images)

**Ailoot · Εικόνες** `POST /v1/images/generations` `qwen-image`

[`qwen-image`](https://ailoot.ai/models/el/#m=qwen-image-3.0-pro&route=Core&caller=qwen-image&fmt=images)

Alibaba /`qwen-image`

ID μοντέλου

- `qwen-image-3.0-pro`
- `qwen-image`
- `qwen-image-latest`

### Εισαγωγή

Μοντέλο δημιουργίας εικόνων από κείμενο, με έμφαση σε σύνθετες μακέτες, επιγραφές και ρεαλιστικές λεπτομέρειες. Είναι κατάλληλο για αφίσες, εικονογραφημένα σενάρια, μενού και υλικό με πυκνή σύνθεση.

Αποδεκτές είσοδοι

Κείμενο

Αποτελέσματα

Εικόνες

### Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι

**Ailoot · Εικόνες** `POST /v1/images/generations`

Είσοδος

`text`

Έξοδος

`image`

Μορφή εξόδου

Αρχείο εικόνας

| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
| --- | --- | --- | --- | --- |
| Πεδίο`model` | Τύπος`string` | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια qwen-image | Προεπιλογή— |
| Πεδίο`prompt` | Τύπος`string` | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο μήκος: 1 | Προεπιλογή— |
| Πεδίο`n` | Τύπος`integer` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 | Προεπιλογή1 |
| Πεδίο`response_format` | Τύπος`string` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια url, b64\_json | Προεπιλογή— |
| Πεδίο`stream` | Τύπος`boolean` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογήfalse |
| Πεδίο`size` | Τύπος`string` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
| Πεδίο`partial_images` | Τύπος`integer` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
| Πεδίο`images[].image_url` | Τύπος`string` | ΑπαίτησηΔεν υποστηρίζεται | Τιμές και όρια Μέγιστο πλήθος αποκωδικοποιημένων byte: 10.485.760 Τύποι MIME: image/png, image/jpeg Μέγιστο πλήθος εικόνων ανά πίνακα: 3 Συνθήκες: Ένα πραγματικό URL ανά αντικείμενο images\[\]. Το πλήθος του πίνακα διαφέρει από αυτή την τελική τιμή συμβολοσειράς. Εφαρμόζεται όταν: Μόνο JSON images/edits· το JSON images/generations δεν αναλύει αναφορές images. | Προεπιλογή— |
| Πεδίο`image` | Τύπος`file` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Μέγιστο πλήθος αποκωδικοποιημένων byte: 10.485.760 Τύποι MIME: image/png, image/jpeg Εφαρμόζεται όταν: δημιουργία με multipart/form-data | Προεπιλογή— |
| Πεδίο`image[]` | Τύπος`file[]` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Μέγιστο πλήθος στοιχείων: 3 Μέγιστο πλήθος αποκωδικοποιημένων byte: 10.485.760 Τύποι MIME: image/png, image/jpeg Εφαρμόζεται όταν: δημιουργία με multipart/form-data | Προεπιλογή— |

Συνδυασμοί υλικών εισόδου

**Κείμενο σε εικόνα** · Υποχρεωτικό: prompt

**reference\_images\_generation** · Υποχρεωτικό: prompt

Παράμετροι και κύκλος ζωής μεθόδου

| Παράμετρος | Σύμβαση |
| --- | --- |
| Παράμετρος`material_types` | Σύμβασηtext |
| Παράμετρος`required` | Σύμβασηmodel, prompt |
| Παράμετρος`optional_controls` | Σύμβασηnull |
| Παράμετρος`content_type` | Σύμβασηapplication/json |

Κύκλος ζωής: `synchronous_result_then_owned_library`

`GET /v1/media/tasks/{task_id}` · Το πραγματικό task\_id που επιστράφηκε ή μια εγγραφή στη βιβλιοθήκη πολυμέσων

`GET /v1/media/assets/{asset_id}/content`

`GET /v1/media/assets`

`GET /v1/media/assets/{asset_id}`

Οι δομές και τα ID των μεθόδων είναι ακριβή· η δυνατότητα του προμηθευτή είναι ξεχωριστή από την αποδοχή αιτημάτων.

### Τιμολόγηση

#### Χρεώσεις μεθόδων Ailoot

Είσοδος

0,003 $ *ανά εικόνα εισόδου*

Έξοδος

0,04 $ *ανά εικόνα ανάλυσης 1K*

Έξοδος

0,075 $ *ανά εικόνα ανάλυσης 2K*

Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. [Πώς λειτουργούν η δέσμευση και η εκκαθάριση →](https://ailoot.ai/docs/el/billing/reserve/)

### Παραδείγματα αιτημάτων

#### Ailoot · Εικόνες

curlPython SDKNode.js SDK

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
export AILOOT_API_KEY
: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"
export AILOOT_PROMPT_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "qwen-image", "prompt": ""}')
f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")
p['prompt']=f.read_text(encoding="utf-8")
if not p['prompt'].strip():raise SystemExit("Brief must contain text")
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        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"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
```

```python
from openai import OpenAI
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        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"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")

f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")
request={'model': 'qwen-image', 'prompt': ''}
request["prompt"]=f.read_text(encoding="utf-8")
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.images.generate(**request)
Path("sdk-result.txt").write_text(str(result),encoding="utf-8")
save_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])
```

```js
import OpenAI from "openai";
import { readFileSync, writeFileSync } from "node:fs";
const key=process.env.AILOOT_API_KEY;
if(!key) throw new Error("Set your actual Ailoot API key");
const client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});
const request={"model": "qwen-image", "prompt": ""};
if(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");
request.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");
const result=await client.images.generate(request);
writeFileSync("sdk-result.json",JSON.stringify(result,null,2));
if(!result.data?.length) throw new Error("No completed images");
for(let index=0;index<result.data.length;index++) {
  const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;
  if(!encoded && uri.startsWith("data:image/")) {
    const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");
    encoded=uri.slice(comma+1);
  }
  if(encoded) {
    if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");
    raw=Buffer.from(encoded,"base64");
  } else if(uri) {
    const u=new URL(uri,"https://api.ailoot.ai");
    if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");
    const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");
    const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});
    if(!response.ok) throw new Error("Image content download failed: "+response.status);
    raw=Buffer.from(await response.arrayBuffer());
  } else throw new Error("Image has neither bytes nor URL");
  if(!raw.length) throw new Error("Empty image result");
  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";
  writeFileSync(`image-${index}.${ext}`,raw);
}
console.log("Every returned image saved; sdk-result.json retains complete metadata");
```

### Λήψη και αποθήκευση αποτελεσμάτων

#### Ailoot · Εικόνες

Κατεβάστε κάθε εικόνα που επιστρέφεται ή αποθηκεύστε το περιεχόμενο Base64

- `GET /v1/media/tasks/{task_id}`
- `GET /v1/media/assets/{asset_id}/content`
- `GET /v1/media/assets`
- `GET /v1/media/assets/{asset_id}`

##### Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα

Αποθηκεύστε κάθε ολοκληρωμένη εικόνα· ανακτήστε κάθε URL που επιστρέφεται ή αποκωδικοποιήστε το περιεχόμενο Base64.

Αποθηκεύστε κάθε στοιχείο δεδομένων. Αποκωδικοποιήστε κάθε b64\_json ή ανακτήστε κάθε υπογεγραμμένο URL που επιστράφηκε. Επιλέξτε την επέκταση του ονόματος αρχείου βάσει του πραγματικού τύπου MIME/των byte.

##### Αν χρειάζεται έλεγχος της αρχικής απάντησης

Αν το αποτέλεσμα παραγωγής ή επεξεργασίας εικόνας χρειάζεται έλεγχο, διατηρήστε το αρχικό operation\_id/X-Client-Request-ID και τις πληροφορίες αποτελέσματος που επιστράφηκαν. Ανακτήστε τα υπάρχοντα αποτελέσματα που σας ανήκουν μέσω της βιβλιοθήκης πολυμέσων χρησιμοποιώντας πραγματικές τιμές task\_id ή asset\_id. Μην υποβάλετε ξανά το αίτημα παραγωγής/επεξεργασίας και μην κατασκευάσετε URL περιοδικού ελέγχου από το operation\_id.

Πεδία απάντησης

| Πεδίο | Τύπος |
| --- | --- |
| Πεδίο`created` | Τύποςinteger |
| Πεδίο`data[].url` | Τύποςstring |
| Πεδίο`data[].b64_json` | Τύποςbase64 string |
| Πεδίο`usage` | Τύποςobject |

Σφάλματα και επόμενα βήματα

| Απάντηση | Συνθήκη | Επόμενο βήμα |
| --- | --- | --- |
| Απάντηση400 · `invalid_request_error` | ΣυνθήκηΜη έγκυρα υποχρεωτικά πεδία, μη έγκυρη αναπαράσταση υλικού ή μη έγκυρη τιμή παραμέτρου | Επόμενο βήμαΔιορθώστε τα υποδεικνυόμενα πεδία πριν από νέο αίτημα δημιουργίας. |
| Απάντηση`server_error` | ΣυνθήκηΗ απόκριση που επιστράφηκε αναφέρει ότι η λειτουργία ή το αποτέλεσμα χρειάζεται έλεγχο | Επόμενο βήμαΔιατηρήστε το αρχικό ID της λειτουργίας/εργασίας που επιστράφηκε, τις κεφαλίδες του αιτήματος και την απόκριση· συνεχίστε με τις υποστηριζόμενες αναγνώσεις αυτής της αρχικής λειτουργίας. Μην υποβάλετε ξανά το αίτημα δημιουργίας. |

### Εναλλακτικά ονόματα

#### Εναλλακτικά ονόματα μοντέλου

**Ailoot** [`qwen-image-3.0-pro`](https://ailoot.ai/models/el/#m=qwen-image-3.0-pro&route=Core&caller=qwen-image-3.0-pro&fmt=images), [`qwen-image`](https://ailoot.ai/models/el/#m=qwen-image-3.0-pro&route=Core&caller=qwen-image&fmt=images), [`qwen-image-latest`](https://ailoot.ai/models/el/#m=qwen-image-3.0-pro&route=Core&caller=qwen-image-latest&fmt=images)

#### Εναλλακτικές διαδρομές μεθόδων

Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.

#### Σχετικά ID μοντέλων

[`qwen-image-3.0-pro`](https://ailoot.ai/models/el/#m=qwen-image-3.0-pro&route=Core&caller=qwen-image-3.0-pro&fmt=images), [`qwen-image`](https://ailoot.ai/models/el/#m=qwen-image-3.0-pro&route=Core&caller=qwen-image&fmt=images), [`qwen-image-latest`](https://ailoot.ai/models/el/#m=qwen-image-3.0-pro&route=Core&caller=qwen-image-latest&fmt=images)

**Ailoot · Εικόνες** `POST /v1/images/generations` `qwen-image-latest`

[`qwen-image-latest`](https://ailoot.ai/models/el/#m=qwen-image-3.0-pro&route=Core&caller=qwen-image-latest&fmt=images)

Alibaba /`qwen-image-latest`

ID μοντέλου

- `qwen-image-3.0-pro`
- `qwen-image`
- `qwen-image-latest`

### Εισαγωγή

Μοντέλο δημιουργίας εικόνων από κείμενο, με έμφαση σε σύνθετες μακέτες, επιγραφές και ρεαλιστικές λεπτομέρειες. Είναι κατάλληλο για αφίσες, εικονογραφημένα σενάρια, μενού και υλικό με πυκνή σύνθεση.

Αποδεκτές είσοδοι

Κείμενο

Αποτελέσματα

Εικόνες

### Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι

**Ailoot · Εικόνες** `POST /v1/images/generations`

Είσοδος

`text`

Έξοδος

`image`

Μορφή εξόδου

Αρχείο εικόνας

| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
| --- | --- | --- | --- | --- |
| Πεδίο`model` | Τύπος`string` | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια qwen-image-latest | Προεπιλογή— |
| Πεδίο`prompt` | Τύπος`string` | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο μήκος: 1 | Προεπιλογή— |
| Πεδίο`n` | Τύπος`integer` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 | Προεπιλογή1 |
| Πεδίο`response_format` | Τύπος`string` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια url, b64\_json | Προεπιλογή— |
| Πεδίο`stream` | Τύπος`boolean` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογήfalse |
| Πεδίο`size` | Τύπος`string` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
| Πεδίο`partial_images` | Τύπος`integer` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Εξαρτάται από το μοντέλο | Προεπιλογή— |
| Πεδίο`images[].image_url` | Τύπος`string` | ΑπαίτησηΔεν υποστηρίζεται | Τιμές και όρια Μέγιστο πλήθος αποκωδικοποιημένων byte: 10.485.760 Τύποι MIME: image/png, image/jpeg Μέγιστο πλήθος εικόνων ανά πίνακα: 3 Συνθήκες: Ένα πραγματικό URL ανά αντικείμενο images\[\]. Το πλήθος του πίνακα διαφέρει από αυτή την τελική τιμή συμβολοσειράς. Εφαρμόζεται όταν: Μόνο JSON images/edits· το JSON images/generations δεν αναλύει αναφορές images. | Προεπιλογή— |
| Πεδίο`image` | Τύπος`file` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Μέγιστο πλήθος αποκωδικοποιημένων byte: 10.485.760 Τύποι MIME: image/png, image/jpeg Εφαρμόζεται όταν: δημιουργία με multipart/form-data | Προεπιλογή— |
| Πεδίο`image[]` | Τύπος`file[]` | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Μέγιστο πλήθος στοιχείων: 3 Μέγιστο πλήθος αποκωδικοποιημένων byte: 10.485.760 Τύποι MIME: image/png, image/jpeg Εφαρμόζεται όταν: δημιουργία με multipart/form-data | Προεπιλογή— |

Συνδυασμοί υλικών εισόδου

**Κείμενο σε εικόνα** · Υποχρεωτικό: prompt

**reference\_images\_generation** · Υποχρεωτικό: prompt

Παράμετροι και κύκλος ζωής μεθόδου

| Παράμετρος | Σύμβαση |
| --- | --- |
| Παράμετρος`material_types` | Σύμβασηtext |
| Παράμετρος`required` | Σύμβασηmodel, prompt |
| Παράμετρος`optional_controls` | Σύμβασηnull |
| Παράμετρος`content_type` | Σύμβασηapplication/json |

Κύκλος ζωής: `synchronous_result_then_owned_library`

`GET /v1/media/tasks/{task_id}` · Το πραγματικό task\_id που επιστράφηκε ή μια εγγραφή στη βιβλιοθήκη πολυμέσων

`GET /v1/media/assets/{asset_id}/content`

`GET /v1/media/assets`

`GET /v1/media/assets/{asset_id}`

Οι δομές και τα ID των μεθόδων είναι ακριβή· η δυνατότητα του προμηθευτή είναι ξεχωριστή από την αποδοχή αιτημάτων.

### Τιμολόγηση

#### Χρεώσεις μεθόδων Ailoot

Είσοδος

0,003 $ *ανά εικόνα εισόδου*

Έξοδος

0,04 $ *ανά εικόνα ανάλυσης 1K*

Έξοδος

0,075 $ *ανά εικόνα ανάλυσης 2K*

Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. [Πώς λειτουργούν η δέσμευση και η εκκαθάριση →](https://ailoot.ai/docs/el/billing/reserve/)

### Παραδείγματα αιτημάτων

#### Ailoot · Εικόνες

curlPython SDKNode.js SDK

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
export AILOOT_API_KEY
: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"
export AILOOT_PROMPT_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "qwen-image-latest", "prompt": ""}')
f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")
p['prompt']=f.read_text(encoding="utf-8")
if not p['prompt'].strip():raise SystemExit("Brief must contain text")
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        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"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
```

```python
from openai import OpenAI
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        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"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")

f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")
request={'model': 'qwen-image-latest', 'prompt': ''}
request["prompt"]=f.read_text(encoding="utf-8")
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.images.generate(**request)
Path("sdk-result.txt").write_text(str(result),encoding="utf-8")
save_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])
```

```js
import OpenAI from "openai";
import { readFileSync, writeFileSync } from "node:fs";
const key=process.env.AILOOT_API_KEY;
if(!key) throw new Error("Set your actual Ailoot API key");
const client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});
const request={"model": "qwen-image-latest", "prompt": ""};
if(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");
request.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");
const result=await client.images.generate(request);
writeFileSync("sdk-result.json",JSON.stringify(result,null,2));
if(!result.data?.length) throw new Error("No completed images");
for(let index=0;index<result.data.length;index++) {
  const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;
  if(!encoded && uri.startsWith("data:image/")) {
    const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");
    encoded=uri.slice(comma+1);
  }
  if(encoded) {
    if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");
    raw=Buffer.from(encoded,"base64");
  } else if(uri) {
    const u=new URL(uri,"https://api.ailoot.ai");
    if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");
    const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");
    const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});
    if(!response.ok) throw new Error("Image content download failed: "+response.status);
    raw=Buffer.from(await response.arrayBuffer());
  } else throw new Error("Image has neither bytes nor URL");
  if(!raw.length) throw new Error("Empty image result");
  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";
  writeFileSync(`image-${index}.${ext}`,raw);
}
console.log("Every returned image saved; sdk-result.json retains complete metadata");
```

### Λήψη και αποθήκευση αποτελεσμάτων

#### Ailoot · Εικόνες

Κατεβάστε κάθε εικόνα που επιστρέφεται ή αποθηκεύστε το περιεχόμενο Base64

- `GET /v1/media/tasks/{task_id}`
- `GET /v1/media/assets/{asset_id}/content`
- `GET /v1/media/assets`
- `GET /v1/media/assets/{asset_id}`

##### Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα

Αποθηκεύστε κάθε ολοκληρωμένη εικόνα· ανακτήστε κάθε URL που επιστρέφεται ή αποκωδικοποιήστε το περιεχόμενο Base64.

Αποθηκεύστε κάθε στοιχείο δεδομένων. Αποκωδικοποιήστε κάθε b64\_json ή ανακτήστε κάθε υπογεγραμμένο URL που επιστράφηκε. Επιλέξτε την επέκταση του ονόματος αρχείου βάσει του πραγματικού τύπου MIME/των byte.

##### Αν χρειάζεται έλεγχος της αρχικής απάντησης

Αν το αποτέλεσμα παραγωγής ή επεξεργασίας εικόνας χρειάζεται έλεγχο, διατηρήστε το αρχικό operation\_id/X-Client-Request-ID και τις πληροφορίες αποτελέσματος που επιστράφηκαν. Ανακτήστε τα υπάρχοντα αποτελέσματα που σας ανήκουν μέσω της βιβλιοθήκης πολυμέσων χρησιμοποιώντας πραγματικές τιμές task\_id ή asset\_id. Μην υποβάλετε ξανά το αίτημα παραγωγής/επεξεργασίας και μην κατασκευάσετε URL περιοδικού ελέγχου από το operation\_id.

Πεδία απάντησης

| Πεδίο | Τύπος |
| --- | --- |
| Πεδίο`created` | Τύποςinteger |
| Πεδίο`data[].url` | Τύποςstring |
| Πεδίο`data[].b64_json` | Τύποςbase64 string |
| Πεδίο`usage` | Τύποςobject |

Σφάλματα και επόμενα βήματα

| Απάντηση | Συνθήκη | Επόμενο βήμα |
| --- | --- | --- |
| Απάντηση400 · `invalid_request_error` | ΣυνθήκηΜη έγκυρα υποχρεωτικά πεδία, μη έγκυρη αναπαράσταση υλικού ή μη έγκυρη τιμή παραμέτρου | Επόμενο βήμαΔιορθώστε τα υποδεικνυόμενα πεδία πριν από νέο αίτημα δημιουργίας. |
| Απάντηση`server_error` | ΣυνθήκηΗ απόκριση που επιστράφηκε αναφέρει ότι η λειτουργία ή το αποτέλεσμα χρειάζεται έλεγχο | Επόμενο βήμαΔιατηρήστε το αρχικό ID της λειτουργίας/εργασίας που επιστράφηκε, τις κεφαλίδες του αιτήματος και την απόκριση· συνεχίστε με τις υποστηριζόμενες αναγνώσεις αυτής της αρχικής λειτουργίας. Μην υποβάλετε ξανά το αίτημα δημιουργίας. |

### Εναλλακτικά ονόματα

#### Εναλλακτικά ονόματα μοντέλου

**Ailoot** [`qwen-image-3.0-pro`](https://ailoot.ai/models/el/#m=qwen-image-3.0-pro&route=Core&caller=qwen-image-3.0-pro&fmt=images), [`qwen-image`](https://ailoot.ai/models/el/#m=qwen-image-3.0-pro&route=Core&caller=qwen-image&fmt=images), [`qwen-image-latest`](https://ailoot.ai/models/el/#m=qwen-image-3.0-pro&route=Core&caller=qwen-image-latest&fmt=images)

#### Εναλλακτικές διαδρομές μεθόδων

Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.

#### Σχετικά ID μοντέλων

[`qwen-image-3.0-pro`](https://ailoot.ai/models/el/#m=qwen-image-3.0-pro&route=Core&caller=qwen-image-3.0-pro&fmt=images), [`qwen-image`](https://ailoot.ai/models/el/#m=qwen-image-3.0-pro&route=Core&caller=qwen-image&fmt=images), [`qwen-image-latest`](https://ailoot.ai/models/el/#m=qwen-image-3.0-pro&route=Core&caller=qwen-image-latest&fmt=images)

FAQ · qwen-image-3.0-pro

Ποιες είσοδοι και αποτελέσματα διατίθενται;

`POST /v1/images/generations` · `qwen-image-3.0-pro`: `text` → `image` `POST /v1/images/generations` · `qwen-image`: `text` → `image` `POST /v1/images/generations` · `qwen-image-latest`: `text` → `image`

Ποια πεδία χρησιμοποιεί το αίτημα;

`POST /v1/images/generations` · `qwen-image-3.0-pro`: `model`, `prompt`, `n`, `response_format`, `stream`, `image`, `image[]` `POST /v1/images/generations` · `qwen-image`: `model`, `prompt`, `n`, `response_format`, `stream`, `image`, `image[]` `POST /v1/images/generations` · `qwen-image-latest`: `model`, `prompt`, `n`, `response_format`, `stream`, `image`, `image[]`

Ποια όρια ισχύουν;

`POST /v1/images/generations` · `qwen-image-3.0-pro`: `n.minimum`: `1` `POST /v1/images/generations` · `qwen-image`: `n.minimum`: `1` `POST /v1/images/generations` · `qwen-image-latest`: `n.minimum`: `1`

Συνδέστε το Ailoot με Claude Code, OpenCode, Hermes ή τη δική σας εφαρμογή.

## Η εταιρεία και το χαρτοφυλάκιο έργων της

Η εταιρεία και το χαρτοφυλάκιο έργων της: εκατομμύρια πελάτες· μηνιαίες πωλήσεις δισεκατομμυρίων.

## Αγοράστε token με έκπτωση.

Έκπτωση συνδρομής για τακτική χρήση. Προωθητικοί κωδικοί — έως 50% στην αγορά token.

Συνδρομή

Επιλέξτε πρόγραμμα με έκπτωση για τα τακτικά αιτήματά σας.

Προωθητικός κωδικός έως 50%

Εισαγάγετε τον κωδικό στην αγορά. Η τιμή επανυπολογίζεται σύμφωνα με την ενεργή προσφορά.

Δαπάνες στο ιστορικό

Μοντέλο, token και ποσό αποθηκεύονται για κάθε αίτημα.

[Επιλέξτε συνδρομή](https://ailoot.ai/docs/el/billing/subscriptions/) · [Δείτε τιμές μοντέλων](https://ailoot.ai/models/el/)

## Συνδέστε το API με το προϊόν που πουλάτε.

SaaS, εφαρμογές και bot — σύμφωνα με τη δημόσια προσφορά και τη σύμβαση άδειας χρήσης Ailoot. Για μεταπώληση ζητήστε σχετική άδεια.

Εμπορική εφαρμογή

Ενσωματώστε δημιουργία κειμένου, εικόνων, βίντεο και ήχου στις πληρωμένες λειτουργίες της υπηρεσίας σας.

Άδεια για μεταπωλητή

Στείλτε περιγραφή έργου και τρόπο πρόσβασης. Ζητήστε γραπτούς όρους χρήσης και μεταπώλησης.

Έγγραφα στον ιστότοπο

Δημόσια προσφορά, σύμβαση άδειας χρήσης και πολιτική επεξεργασίας δεδομένων είναι διαθέσιμες πριν τη σύνδεση.

[Ζητήστε άδεια μεταπώλησης](mailto:support@ailoot.ai) · [Δημόσια προσφορά και σύμβαση άδειας χρήσης](https://ailoot.ai/legal/offer?lang=el)

## Ailoot · Η εταιρεία και το χαρτοφυλάκιο έργων της





Η Ailoot στηρίζεται στη συσσωρευμένη λειτουργική εμπειρία, τη μεγάλη πελατειακή βάση, τη σταθερή εξυπηρέτηση και τον συνεχή έλεγχο KPI.





Η εταιρεία και το χαρτοφυλάκιο έργων της: εκατομμύρια πελάτες· μηνιαίες πωλήσεις δισεκατομμυρίων.





Η Ailoot αξιοποιεί αυτή τη λειτουργική εμπειρία για πρόσβαση μέσω API σε λειτουργίες AI στα προϊόντα, τους πράκτορες, τις εφαρμογές και τους αυτοματισμούς των πελατών.