Recraft V3 è un modello di generazione immagini costruito per il design grafico oltre a scene fotografiche e illustrate. Un brief scritto descrive soggetto, ambientazione e composizione; il risultato è un’immagine. V3 sviluppa la resa del testo e il fotorealismo di Recraft mantenendo la coerenza stilistica da immagini d’esempio senza riaddestramento.
V3 lavora con testo all’interno dell’immagine, inclusi testi più lunghi e scritte medie. Recraft descrive una fase di layout che stabilisce parole e loro posizioni prima della generazione dell’immagine. Il layout può essere prodotto automaticamente dal brief o disposto manualmente nell’ambiente di design Recraft. Questo aiuta a collegare titolo, illustrazione e testo di supporto in una composizione. Il produttore documenta anche coordinate esplicite di layout testuale, espresse relativamente all’immagine anziché come griglia fissa di pixel. Ogni elemento testuale contiene una sola parola e quattro punti angolari in coordinate normalizzate: (0, 0) è l’angolo superiore sinistro e (1, 1) quello inferiore destro. Le coordinate possono estendersi oltre quell’intervallo, nel qual caso la forma viene ritagliata. Le parole del layout testuale esplicito devono seguire le restrizioni documentate sui caratteri.
Per un poster o una copertina, fornisci il testo esatto e descrivine la gerarchia: quale riga guida, dove si colloca e come l’immagine la supporta. Controlla ortografia e spaziatura rese quando selezioni un risultato.
V3 include stili curati fotografici, illustrativi e di emblemi, oltre a una libreria separata di stili vettoriali. Recraft V3 Raw è lo stile predefinito del modello raster; Vector art è quello della variante vettoriale. Photorealism mira a un aspetto fotografico, mentre Illustration accoglie texture stilizzate, ombreggiatura e transizioni cromatiche più complesse. Gli stili vettoriali preferiscono forme, tavolozze limitate e riempimenti piatti o gradienti semplici.
Gli stili personalizzati possono essere costruiti da immagini di riferimento, stili compatibili esistenti o una combinazione. Forniscono una direzione visiva riutilizzabile fra una serie di immagini. I controlli di miscelazione documentati permettono a riferimenti e stili sorgente di avere pesi separati; il numero dei pesi corrisponde alle sorgenti. PaletteMatch e MaxWeight sono le due politiche di miscelazione elencate. Il produttore consente fino a 10 immagini di riferimento stilistico e usa la modalità regolare di corrispondenza dello stile per V3. Uno stile personalizzato memorizzato e riferimenti stilistici diretti sono input alternativi e uno stile personalizzato deve corrispondere al modello usato per la generazione.
Colori preferiti e colore di sfondo guidano la tavolozza. Sono documentati fino a 10 colori RGB, con ogni componente da 0 a 255. I pesi relativi facoltativi vanno da 0 a 1; devono essere forniti per tutti i colori o per nessuno e il loro totale non può superare 1. Il livello artistico va da 0 per un trattamento statico e pulito a 5 per composizioni più dinamiche ed eccentriche. Un prompt negativo descrive elementi indesiderati; un controllo no-text separato disattiva i layout testuali incorporati. È disponibile un seed casuale per la riproducibilità. Questi controlli offrono leve diverse per scena, stile e layout visivo.
Recraft documenta due varianti V3. Il modello raster produce WebP senza perdita o PNG ed è adatto a dettaglio fotografico, ombreggiatura e illustrazioni materiche. Recraft V3 Vector produce SVG: tracciati e forme scalabili senza risoluzione fissa in pixel. È adatto a pittogrammi, concept di logo, distintivi ed elaborati vettoriali dettagliati. La conversione raster-vettore è un’operazione separata dalla generazione diretta di elaborati vettoriali.
Entrambe le varianti hanno una propria identità. Un’immagine dall’aspetto vettoriale e un output SVG effettivo sono scelte diverse. Seleziona l’output previsto quando prepari un flusso di design, anziché trattare il nome V3 condiviso come prova che ogni operazione restituisca lo stesso tipo di file.
La documentazione V3 di Recraft elenca generazione image-to-image, inpainting, outpainting e sostituzione o generazione dello sfondo. Il lavoro image-to-image combina un’immagine esistente con un nuovo brief. L’inpainting rigenera la zona selezionata usando un’immagine e una maschera corrispondente; l’outpainting aggiunge contenuto oltre l’inquadratura originale. Le operazioni di sfondo riguardano l’ambiente del soggetto.
Gli strumenti associati includono anche cancellazione, rimozione dello sfondo, vettorializzazione e due approcci di upscaling. L’upscaling creativo può introdurre nuovi dettagli; quello nitido mira a una rappresentazione più grande e definita del contenuto esistente. Sono operazioni distinte con input e risultati propri, anziché significati aggiuntivi del nome del modello raster o vettoriale.
La specifica di generazione V3 del produttore accetta un prompt fino a 1000 caratteri e 1–6 immagini per richiesta. Supporta 14 rapporti d’aspetto: 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 6:10, 14:10, 10:14, 16:9 e 9:16. Gli esempi raster documentati includono 1024x1024, 1820x1024 e 1024x1820. Le dimensioni raster esatte devono appartenere all’elenco supportato; SVG usa rapporti d’aspetto senza dimensioni fisse in pixel. Quando le dimensioni sono omesse, il sistema del produttore le seleziona dal prompt.
Per le operazioni con immagini in ingresso, il produttore elenca PNG, JPG e WebP, con SVG dove l’operazione specifica lo consente. I file devono essere sotto 20 MB, non oltre 16 MP, con lato più lungo al massimo di 4096 pixel. Il lato più corto è di almeno 256 pixel, con un’eccezione di 32 pixel per l’upscaling nitido. Le maschere corrispondono alle dimensioni dell’immagine e usano bianco e nero puri; i riferimenti stilistici hanno un limite complessivo di 64 MB.
Per un progetto Ailoot API, trasforma l’attività in un brief mirato per immagini: testo esatto, disposizione degli oggetti, stile visivo e composizione desiderata. Un poster, una scena di prodotto e una serie di icone richiedono brief diversi; conserva le distinzioni pertinenti fra varianti V3 e operazioni nel decidere come sarà usato ogni risultato.
", "aboutText": "Recraft V3 è un modello di generazione immagini costruito per il design grafico oltre a scene fotografiche e illustrate. Un brief scritto descrive soggetto, ambientazione e composizione; il risultato è un’immagine. V3 sviluppa la resa del testo e il fotorealismo di Recraft mantenendo la coerenza stilistica da immagini d’esempio senza riaddestramento.\n\n### Il testo come parte della composizione\n\nV3 lavora con testo all’interno dell’immagine, inclusi testi più lunghi e scritte medie. Recraft descrive una fase di layout che stabilisce parole e loro posizioni prima della generazione dell’immagine. Il layout può essere prodotto automaticamente dal brief o disposto manualmente nell’ambiente di design Recraft. Questo aiuta a collegare titolo, illustrazione e testo di supporto in una composizione. Il produttore documenta anche coordinate esplicite di layout testuale, espresse relativamente all’immagine anziché come griglia fissa di pixel. Ogni elemento testuale contiene una sola parola e quattro punti angolari in coordinate normalizzate: (0, 0) è l’angolo superiore sinistro e (1, 1) quello inferiore destro. Le coordinate possono estendersi oltre quell’intervallo, nel qual caso la forma viene ritagliata. Le parole del layout testuale esplicito devono seguire le restrizioni documentate sui caratteri.\n\nPer un poster o una copertina, fornisci il testo esatto e descrivine la gerarchia: quale riga guida, dove si colloca e come l’immagine la supporta. Controlla ortografia e spaziatura rese quando selezioni un risultato.\n\n### Stile, tavolozza e direzione artistica\n\nV3 include stili curati fotografici, illustrativi e di emblemi, oltre a una libreria separata di stili vettoriali. Recraft V3 Raw è lo stile predefinito del modello raster; Vector art è quello della variante vettoriale. Photorealism mira a un aspetto fotografico, mentre Illustration accoglie texture stilizzate, ombreggiatura e transizioni cromatiche più complesse. Gli stili vettoriali preferiscono forme, tavolozze limitate e riempimenti piatti o gradienti semplici.\n\nGli stili personalizzati possono essere costruiti da immagini di riferimento, stili compatibili esistenti o una combinazione. Forniscono una direzione visiva riutilizzabile fra una serie di immagini. I controlli di miscelazione documentati permettono a riferimenti e stili sorgente di avere pesi separati; il numero dei pesi corrisponde alle sorgenti. PaletteMatch e MaxWeight sono le due politiche di miscelazione elencate. Il produttore consente fino a 10 immagini di riferimento stilistico e usa la modalità regolare di corrispondenza dello stile per V3. Uno stile personalizzato memorizzato e riferimenti stilistici diretti sono input alternativi e uno stile personalizzato deve corrispondere al modello usato per la generazione.\n\nColori preferiti e colore di sfondo guidano la tavolozza. Sono documentati fino a 10 colori RGB, con ogni componente da 0 a 255. I pesi relativi facoltativi vanno da 0 a 1; devono essere forniti per tutti i colori o per nessuno e il loro totale non può superare 1. Il livello artistico va da 0 per un trattamento statico e pulito a 5 per composizioni più dinamiche ed eccentriche. Un prompt negativo descrive elementi indesiderati; un controllo no-text separato disattiva i layout testuali incorporati. È disponibile un seed casuale per la riproducibilità. Questi controlli offrono leve diverse per scena, stile e layout visivo.\n\n### Immagini raster e una variante SVG separata\n\nRecraft documenta due varianti V3. Il modello raster produce WebP senza perdita o PNG ed è adatto a dettaglio fotografico, ombreggiatura e illustrazioni materiche. Recraft V3 Vector produce SVG: tracciati e forme scalabili senza risoluzione fissa in pixel. È adatto a pittogrammi, concept di logo, distintivi ed elaborati vettoriali dettagliati. La conversione raster-vettore è un’operazione separata dalla generazione diretta di elaborati vettoriali.\n\nEntrambe le varianti hanno una propria identità. Un’immagine dall’aspetto vettoriale e un output SVG effettivo sono scelte diverse. Seleziona l’output previsto quando prepari un flusso di design, anziché trattare il nome V3 condiviso come prova che ogni operazione restituisca lo stesso tipo di file.\n\n### Modifica e finitura di elaborati esistenti\n\nLa documentazione V3 di Recraft elenca generazione image-to-image, inpainting, outpainting e sostituzione o generazione dello sfondo. Il lavoro image-to-image combina un’immagine esistente con un nuovo brief. L’inpainting rigenera la zona selezionata usando un’immagine e una maschera corrispondente; l’outpainting aggiunge contenuto oltre l’inquadratura originale. Le operazioni di sfondo riguardano l’ambiente del soggetto.\n\nGli strumenti associati includono anche cancellazione, rimozione dello sfondo, vettorializzazione e due approcci di upscaling. L’upscaling creativo può introdurre nuovi dettagli; quello nitido mira a una rappresentazione più grande e definita del contenuto esistente. Sono operazioni distinte con input e risultati propri, anziché significati aggiuntivi del nome del modello raster o vettoriale.\n\n### Limiti di prompt, dimensioni e immagini sorgente\n\nLa specifica di generazione V3 del produttore accetta un prompt fino a 1000 caratteri e 1–6 immagini per richiesta. Supporta 14 rapporti d’aspetto: 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 6:10, 14:10, 10:14, 16:9 e 9:16. Gli esempi raster documentati includono 1024x1024, 1820x1024 e 1024x1820. Le dimensioni raster esatte devono appartenere all’elenco supportato; SVG usa rapporti d’aspetto senza dimensioni fisse in pixel. Quando le dimensioni sono omesse, il sistema del produttore le seleziona dal prompt.\n\nPer le operazioni con immagini in ingresso, il produttore elenca PNG, JPG e WebP, con SVG dove l’operazione specifica lo consente. I file devono essere sotto 20 MB, non oltre 16 MP, con lato più lungo al massimo di 4096 pixel. Il lato più corto è di almeno 256 pixel, con un’eccezione di 32 pixel per l’upscaling nitido. Le maschere corrispondono alle dimensioni dell’immagine e usano bianco e nero puri; i riferimenti stilistici hanno un limite complessivo di 64 MB.\n\nPer un progetto Ailoot API, trasforma l’attività in un brief mirato per immagini: testo esatto, disposizione degli oggetti, stile visivo e composizione desiderata. Un poster, una scena di prodotto e una serie di icone richiedono brief diversi; conserva le distinzioni pertinenti fra varianti V3 e operazioni nel decidere come sarà usato ogni risultato.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "6743d809e6338a63df3d3edc1b4be0df94f57bc9aeae181d7c7e66c9338b5f4c", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "it", "methods": [ { "html": "recraft/recraft-v3Recraft V3 crea fotografie, illustrazioni e layout grafici con composizione attenta al testo e controlli stilistici. Le varianti raster e SVG distinte si adattano a poster, insiemi di immagini di marca, icone e design in cui testo e struttura visiva devono funzionare insieme.
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
Recraft V3 è un modello di generazione immagini costruito per il design grafico oltre a scene fotografiche e illustrate. Un brief scritto descrive soggetto, ambientazione e composizione; il risultato è un’immagine. V3 sviluppa la resa del testo e il fotorealismo di Recraft mantenendo la coerenza stilistica da immagini d’esempio senza riaddestramento.
V3 lavora con testo all’interno dell’immagine, inclusi testi più lunghi e scritte medie. Recraft descrive una fase di layout che stabilisce parole e loro posizioni prima della generazione dell’immagine. Il layout può essere prodotto automaticamente dal brief o disposto manualmente nell’ambiente di design Recraft. Questo aiuta a collegare titolo, illustrazione e testo di supporto in una composizione. Il produttore documenta anche coordinate esplicite di layout testuale, espresse relativamente all’immagine anziché come griglia fissa di pixel. Ogni elemento testuale contiene una sola parola e quattro punti angolari in coordinate normalizzate: (0, 0) è l’angolo superiore sinistro e (1, 1) quello inferiore destro. Le coordinate possono estendersi oltre quell’intervallo, nel qual caso la forma viene ritagliata. Le parole del layout testuale esplicito devono seguire le restrizioni documentate sui caratteri.
Per un poster o una copertina, fornisci il testo esatto e descrivine la gerarchia: quale riga guida, dove si colloca e come l’immagine la supporta. Controlla ortografia e spaziatura rese quando selezioni un risultato.
V3 include stili curati fotografici, illustrativi e di emblemi, oltre a una libreria separata di stili vettoriali. Recraft V3 Raw è lo stile predefinito del modello raster; Vector art è quello della variante vettoriale. Photorealism mira a un aspetto fotografico, mentre Illustration accoglie texture stilizzate, ombreggiatura e transizioni cromatiche più complesse. Gli stili vettoriali preferiscono forme, tavolozze limitate e riempimenti piatti o gradienti semplici.
Gli stili personalizzati possono essere costruiti da immagini di riferimento, stili compatibili esistenti o una combinazione. Forniscono una direzione visiva riutilizzabile fra una serie di immagini. I controlli di miscelazione documentati permettono a riferimenti e stili sorgente di avere pesi separati; il numero dei pesi corrisponde alle sorgenti. PaletteMatch e MaxWeight sono le due politiche di miscelazione elencate. Il produttore consente fino a 10 immagini di riferimento stilistico e usa la modalità regolare di corrispondenza dello stile per V3. Uno stile personalizzato memorizzato e riferimenti stilistici diretti sono input alternativi e uno stile personalizzato deve corrispondere al modello usato per la generazione.
Colori preferiti e colore di sfondo guidano la tavolozza. Sono documentati fino a 10 colori RGB, con ogni componente da 0 a 255. I pesi relativi facoltativi vanno da 0 a 1; devono essere forniti per tutti i colori o per nessuno e il loro totale non può superare 1. Il livello artistico va da 0 per un trattamento statico e pulito a 5 per composizioni più dinamiche ed eccentriche. Un prompt negativo descrive elementi indesiderati; un controllo no-text separato disattiva i layout testuali incorporati. È disponibile un seed casuale per la riproducibilità. Questi controlli offrono leve diverse per scena, stile e layout visivo.
Recraft documenta due varianti V3. Il modello raster produce WebP senza perdita o PNG ed è adatto a dettaglio fotografico, ombreggiatura e illustrazioni materiche. Recraft V3 Vector produce SVG: tracciati e forme scalabili senza risoluzione fissa in pixel. È adatto a pittogrammi, concept di logo, distintivi ed elaborati vettoriali dettagliati. La conversione raster-vettore è un’operazione separata dalla generazione diretta di elaborati vettoriali.
Entrambe le varianti hanno una propria identità. Un’immagine dall’aspetto vettoriale e un output SVG effettivo sono scelte diverse. Seleziona l’output previsto quando prepari un flusso di design, anziché trattare il nome V3 condiviso come prova che ogni operazione restituisca lo stesso tipo di file.
La documentazione V3 di Recraft elenca generazione image-to-image, inpainting, outpainting e sostituzione o generazione dello sfondo. Il lavoro image-to-image combina un’immagine esistente con un nuovo brief. L’inpainting rigenera la zona selezionata usando un’immagine e una maschera corrispondente; l’outpainting aggiunge contenuto oltre l’inquadratura originale. Le operazioni di sfondo riguardano l’ambiente del soggetto.
Gli strumenti associati includono anche cancellazione, rimozione dello sfondo, vettorializzazione e due approcci di upscaling. L’upscaling creativo può introdurre nuovi dettagli; quello nitido mira a una rappresentazione più grande e definita del contenuto esistente. Sono operazioni distinte con input e risultati propri, anziché significati aggiuntivi del nome del modello raster o vettoriale.
La specifica di generazione V3 del produttore accetta un prompt fino a 1000 caratteri e 1–6 immagini per richiesta. Supporta 14 rapporti d’aspetto: 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 6:10, 14:10, 10:14, 16:9 e 9:16. Gli esempi raster documentati includono 1024x1024, 1820x1024 e 1024x1820. Le dimensioni raster esatte devono appartenere all’elenco supportato; SVG usa rapporti d’aspetto senza dimensioni fisse in pixel. Quando le dimensioni sono omesse, il sistema del produttore le seleziona dal prompt.
Per le operazioni con immagini in ingresso, il produttore elenca PNG, JPG e WebP, con SVG dove l’operazione specifica lo consente. I file devono essere sotto 20 MB, non oltre 16 MP, con lato più lungo al massimo di 4096 pixel. Il lato più corto è di almeno 256 pixel, con un’eccezione di 32 pixel per l’upscaling nitido. Le maschere corrispondono alle dimensioni dell’immagine e usano bianco e nero puri; i riferimenti stilistici hanno un limite complessivo di 64 MB.
Per un progetto Ailoot API, trasforma l’attività in un brief mirato per immagini: testo esatto, disposizione degli oggetti, stile visivo e composizione desiderata. Un poster, una scena di prodotto e una serie di icone richiedono brief diversi; conserva le distinzioni pertinenti fra varianti V3 e operazioni nel decidere come sarà usato ogni risultato.
POST /v1/images/generationstext, imageimage| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti recraft/recraft-v3 | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | Valori e limiti Lunghezza minima: 1 | Predefinito— |
Campon | Tipointeger | RequisitoFacoltativo | Valori e limiti Minimo: 1 Massimo: 6 | Predefinito— |
Campoaspect_ratio | Tipostring | RequisitoFacoltativo | Valori e limiti 1:1, 4:3, 3:4, 16:9, 9:16, auto | Predefinito— |
Campoinput_references | Tipoarray | RequisitoFacoltativo | Valori e limiti Numero minimo di elementi: 0 Numero massimo di elementi: 1 | Predefinito— |
Da testo a immagine · Obbligatorio: prompt
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, prompt |
Parametromaterial_types | Contrattotext, image |
Parametrooptional_controls | Contrattoaspect_ratio, n, input_references |
Parametroexact_supported_parameters | Contratto{"aspect_ratio":{"type":"enum","values":["1:1","4:3","3:4","16:9","9:16","auto"]},"n":{"type":"range","min":1,"max":6},"input_references":{"type":"range","min":0,"max":1}} |
Parametroreference_material_rule | ContrattoSolo riferimenti a immagini reali del cliente; si applicano le condizioni dell'endpoint del fornitore. |
Alias del metodo: /v1/images
Ciclo di vita: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id effettivamente restituito o record della libreria multimediale
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Usa il modello esatto e i campi di input documentati.
Conserva la risposta completa, ogni risultato effettivo e gli ID originali restituiti.
Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile.
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.
| Configurazione | Listino delle tariffe | Quantità prevista | Unità di fatturazione | Costo |
|---|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità prevista— | Unità di fatturazione— | Costo Input · Token in input · Stima solo a fini di confronto — / 1K token Output · Token in output · Stima solo a fini di confronto — / 1K token Input · Lettura dalla cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache, 1 ora · Stima solo a fini di confronto — / 1K token |
| ConfigurazioneUltra | Listino delle tariffe— | Quantità prevista— | Unità di fatturazioneper immagine in output | Costo Output · immagine in uscita · Stima solo a fini di confronto $0.08 per immagine in output |
| ConfigurazioneCosto stimato della generazione | Listino delle tariffe— | Quantità previstastima per una generazione | Unità di fatturazione— | Costo Output · Costo di generazione stimato · Stima solo a fini di confronto $0.08 stima prima della generazione Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata. |
Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
I listini di riferimento del modello non modificano la selezione del metodo, i preventivi o gli addebiti. Gli addebiti attivi usano le tariffe del metodo Ailoot selezionato.
| Configurazione | Condizioni di fatturazione | Costo |
|---|---|---|
| ConfigurazioneImmagine in uscita | Condizioni di fatturazioneNon è dichiarata alcuna variante tariffaria. | Costo Output · Immagine in uscita $0.08 per immagine Le voci equivalenti descrivono lo stesso addebito; non aggiungono un secondo costo. |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'recraft/recraft-v3', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\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\nrequest={'model': 'recraft/recraft-v3', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\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": "recraft/recraft-v3", "prompt": "a red panda astronaut floating in space, studio lighting"};\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");\nScarica ogni immagine restituita o salvane il contenuto Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Salva ogni immagine completata; recupera ogni URL restituito oppure decodificane il contenuto Base64.
Conserva ogni elemento di dati e tutti i dati di utilizzo; acquisisci e salva tutte le immagini effettivamente restituite come risorse di tua proprietà. Nessun URL o ID inventato.
Se il risultato di una generazione o modifica di immagini richiede una verifica, conserva operation_id/X-Client-Request-ID originale e le informazioni sul risultato restituito. Recupera i risultati esistenti che ti appartengono tramite la libreria multimediale usando i valori effettivi di task_id o asset_id. Non reinviare la richiesta di generazione/modifica e non costruire un URL di polling a partire da operation_id.
| Campo | Tipo |
|---|---|
Campocreated | Tipointeger |
Campodata[].url | Tipostring |
Campodata[].b64_json | Tipobase64 string |
Campousage | Tipoobject |
Ailoot Ultra recraft/recraft-v3
/v1/images