{ "aboutHtml": "

Recraft V4.1 Pro Vector è l’edizione SVG Pro della famiglia V4.1 di generazione di immagini di Recraft. È progettata per lavori il cui risultato deve rimanere grafica vettoriale modificabile: un logo, un concetto tipografico, un’icona o un’illustrazione. La presentazione V4.1 del produttore sottolinea composizione e illustrazione intenzionali, mentre la documentazione esatta del modello identifica questa variante separatamente dalle edizioni Vector standard, Pro raster e Utility. La sua immagine finale è un SVG anziché un’esportazione raster ad alta risoluzione.

Il codice del modello del produttore è recraftv4_1_pro_vector. L’output vettoriale non ha dimensioni fisse in pixel; la documentazione sulle dimensioni accetta quattordici rapporti larghezza/altezza per i modelli vettoriali e non accetta dimensioni esatte in pixel. Le impostazioni raster 2K di Pro non definiscono quindi la risoluzione SVG di questa edizione. Specifica le proporzioni desiderate e come verrà usata la grafica. Per un logo, il risultato importante è una silhouette leggibile e aree di colore modificabili che possano essere adattate in un flusso di design.

Il modello supporta generazione da testo a immagine e riferimenti facoltativi di stile personalizzato. Il limite documentato del prompt è di 10,000 caratteri. Colori preferiti, un colore di sfondo desiderato e un seed casuale possono guidare la generazione e il flusso consente da uno a sei output. Uno stile salvato compatibile o immagini di riferimento possono stabilire un linguaggio visivo; lo stile deve corrispondere al modello per cui è stato creato. La linea principale V4.1 non richiede uno stile di riferimento in ogni richiesta, a differenza della famiglia dedicata V4 Styles. Per la generazione basata su riferimenti di stile, usa da una a dieci immagini PNG, JPG o WebP, per un totale non superiore a 64 MB e meno di 20 MB ciascuna. Ogni riferimento deve avere il lato più corto di almeno 256 pixel, il lato più lungo non superiore a 4,096 pixel e una risoluzione non superiore a 16 megapixel. Usa questi riferimenti oppure uno stile salvato compatibile, senza combinarli. Per la generazione basata su riferimenti di stile, la corrispondenza flexible consente un’interpretazione più libera, mentre precise segue più fedelmente resa, palette, composizione e illuminazione.

Un brief vettoriale utile definisce tipo di grafica, logica delle forme, palette, trattamento delle linee e disposizione prima di aggiungere dettagli decorativi. Per l’emblema di un negozio di giardinaggio, richiedi la silhouette di un singolo germoglio, geometria arrotondata, due colori piatti e una composizione centrata. Per il lettering, includi la parola esatta e descrivine gerarchia e forma, quindi esamina l’SVG restituito per verificare controforme leggibili, spaziatura e chiarezza a piccole dimensioni. Gli esempi vettoriali del produttore supportano tipografia espressiva e illustrazione; non garantiscono che ogni lettera o tracciato generato sia già un’opera finita.

Recraft documenta un flusso separato da immagine a immagine per i modelli raster e vettoriali V4.1. Combina un’immagine esistente e un prompt, con strength da 0 a 1 che controlla quanto il nuovo risultato si discosta dall’originale. Valori più bassi restano più vicini e valori più alti consentono cambiamenti maggiori. Questa operazione non accetta controlli di stile personalizzato V4/V4.1: trasformazione dell’immagine sorgente e generazione basata su riferimenti di stile devono quindi essere preparate come flussi distinti. L’input immagine può essere PNG, JPG, WebP o SVG entro i limiti documentati. Per la trasformazione da immagine a immagine, fornisci PNG, JPG, WebP o SVG sotto 20 MB, non oltre 16 megapixel, con entrambi i lati tra 256 e 4,096 pixel.

V4.1 non supporta nomi di stili predefiniti né i controlli negative_prompt, text_layout, artistic_level o no_text. Specifica disposizione e scritte desiderate nel brief positivo invece di affidarti ai precedenti meccanismi V3. Per un elemento di marca dettagliato, usa l’SVG come file di lavoro, esamina la geometria e adatta colori o forme secondo necessità prima di inserirlo nel layout finale. Questa edizione Pro Vector mantiene la propria identità; non è intercambiabile con le varianti raster standard o Utility soltanto perché condividono il nome V4.1.

Tramite Ailoot, seleziona questo esatto ID del modello in /v1/images/generations e fornisci il prompt creativo. Conserva ogni voce data restituita, sia che la risposta contenga un URL sia che contenga dati immagine codificati, e salva i byte effettivi con il tipo di contenuto restituito. Mantieni usage e l’eventuale task_id multimediale insieme al file, quindi verifica forme, scritte e aree di colore nel progetto previsto.

", "aboutText": "Recraft V4.1 Pro Vector è l’edizione SVG Pro della famiglia V4.1 di generazione di immagini di Recraft. È progettata per lavori il cui risultato deve rimanere grafica vettoriale modificabile: un logo, un concetto tipografico, un’icona o un’illustrazione. La presentazione V4.1 del produttore sottolinea composizione e illustrazione intenzionali, mentre la documentazione esatta del modello identifica questa variante separatamente dalle edizioni Vector standard, Pro raster e Utility. La sua immagine finale è un SVG anziché un’esportazione raster ad alta risoluzione.\n\nIl codice del modello del produttore è recraftv4_1_pro_vector. L’output vettoriale non ha dimensioni fisse in pixel; la documentazione sulle dimensioni accetta quattordici rapporti larghezza/altezza per i modelli vettoriali e non accetta dimensioni esatte in pixel. Le impostazioni raster 2K di Pro non definiscono quindi la risoluzione SVG di questa edizione. Specifica le proporzioni desiderate e come verrà usata la grafica. Per un logo, il risultato importante è una silhouette leggibile e aree di colore modificabili che possano essere adattate in un flusso di design.\n\nIl modello supporta generazione da testo a immagine e riferimenti facoltativi di stile personalizzato. Il limite documentato del prompt è di 10,000 caratteri. Colori preferiti, un colore di sfondo desiderato e un seed casuale possono guidare la generazione e il flusso consente da uno a sei output. Uno stile salvato compatibile o immagini di riferimento possono stabilire un linguaggio visivo; lo stile deve corrispondere al modello per cui è stato creato. La linea principale V4.1 non richiede uno stile di riferimento in ogni richiesta, a differenza della famiglia dedicata V4 Styles. Per la generazione basata su riferimenti di stile, usa da una a dieci immagini PNG, JPG o WebP, per un totale non superiore a 64 MB e meno di 20 MB ciascuna. Ogni riferimento deve avere il lato più corto di almeno 256 pixel, il lato più lungo non superiore a 4,096 pixel e una risoluzione non superiore a 16 megapixel. Usa questi riferimenti oppure uno stile salvato compatibile, senza combinarli. Per la generazione basata su riferimenti di stile, la corrispondenza flexible consente un’interpretazione più libera, mentre precise segue più fedelmente resa, palette, composizione e illuminazione.\n\nUn brief vettoriale utile definisce tipo di grafica, logica delle forme, palette, trattamento delle linee e disposizione prima di aggiungere dettagli decorativi. Per l’emblema di un negozio di giardinaggio, richiedi la silhouette di un singolo germoglio, geometria arrotondata, due colori piatti e una composizione centrata. Per il lettering, includi la parola esatta e descrivine gerarchia e forma, quindi esamina l’SVG restituito per verificare controforme leggibili, spaziatura e chiarezza a piccole dimensioni. Gli esempi vettoriali del produttore supportano tipografia espressiva e illustrazione; non garantiscono che ogni lettera o tracciato generato sia già un’opera finita.\n\nRecraft documenta un flusso separato da immagine a immagine per i modelli raster e vettoriali V4.1. Combina un’immagine esistente e un prompt, con strength da 0 a 1 che controlla quanto il nuovo risultato si discosta dall’originale. Valori più bassi restano più vicini e valori più alti consentono cambiamenti maggiori. Questa operazione non accetta controlli di stile personalizzato V4/V4.1: trasformazione dell’immagine sorgente e generazione basata su riferimenti di stile devono quindi essere preparate come flussi distinti. L’input immagine può essere PNG, JPG, WebP o SVG entro i limiti documentati. Per la trasformazione da immagine a immagine, fornisci PNG, JPG, WebP o SVG sotto 20 MB, non oltre 16 megapixel, con entrambi i lati tra 256 e 4,096 pixel.\n\nV4.1 non supporta nomi di stili predefiniti né i controlli negative_prompt, text_layout, artistic_level o no_text. Specifica disposizione e scritte desiderate nel brief positivo invece di affidarti ai precedenti meccanismi V3. Per un elemento di marca dettagliato, usa l’SVG come file di lavoro, esamina la geometria e adatta colori o forme secondo necessità prima di inserirlo nel layout finale. Questa edizione Pro Vector mantiene la propria identità; non è intercambiabile con le varianti raster standard o Utility soltanto perché condividono il nome V4.1.\n\nTramite Ailoot, seleziona questo esatto ID del modello in /v1/images/generations e fornisci il prompt creativo. Conserva ogni voce data restituita, sia che la risposta contenga un URL sia che contenga dati immagine codificati, e salva i byte effettivi con il tipo di contenuto restituito. Mantieni usage e l’eventuale task_id multimediale insieme al file, quindi verifica forme, scritte e aree di colore nel progetto previsto.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "bfdfee6b5463d6b38c868218802061cffbb8f29e44c69429222e7cbb26e22f53", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "it", "methods": [ { "html": "
•

Recraft: Recraft V4.1 Pro Vector

Altro /recraft/recraft-v4.1-pro-vector

Introduzione

Recraft V4.1 Pro Vector crea grafica SVG modificabile per loghi, lettering e illustrazioni dettagliate. È l’edizione vettoriale Pro della famiglia V4.1, che combina prompt testuali con input facoltativi di immagini e stili mantenendo un risultato vettoriale.

Input accettati
Testo · Immagini
Risultati
Immagini
Informazioni sul modello

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 V4.1 Pro Vector è l’edizione SVG Pro della famiglia V4.1 di generazione di immagini di Recraft. È progettata per lavori il cui risultato deve rimanere grafica vettoriale modificabile: un logo, un concetto tipografico, un’icona o un’illustrazione. La presentazione V4.1 del produttore sottolinea composizione e illustrazione intenzionali, mentre la documentazione esatta del modello identifica questa variante separatamente dalle edizioni Vector standard, Pro raster e Utility. La sua immagine finale è un SVG anziché un’esportazione raster ad alta risoluzione.

Il codice del modello del produttore è recraftv4_1_pro_vector. L’output vettoriale non ha dimensioni fisse in pixel; la documentazione sulle dimensioni accetta quattordici rapporti larghezza/altezza per i modelli vettoriali e non accetta dimensioni esatte in pixel. Le impostazioni raster 2K di Pro non definiscono quindi la risoluzione SVG di questa edizione. Specifica le proporzioni desiderate e come verrà usata la grafica. Per un logo, il risultato importante è una silhouette leggibile e aree di colore modificabili che possano essere adattate in un flusso di design.

Il modello supporta generazione da testo a immagine e riferimenti facoltativi di stile personalizzato. Il limite documentato del prompt è di 10,000 caratteri. Colori preferiti, un colore di sfondo desiderato e un seed casuale possono guidare la generazione e il flusso consente da uno a sei output. Uno stile salvato compatibile o immagini di riferimento possono stabilire un linguaggio visivo; lo stile deve corrispondere al modello per cui è stato creato. La linea principale V4.1 non richiede uno stile di riferimento in ogni richiesta, a differenza della famiglia dedicata V4 Styles. Per la generazione basata su riferimenti di stile, usa da una a dieci immagini PNG, JPG o WebP, per un totale non superiore a 64 MB e meno di 20 MB ciascuna. Ogni riferimento deve avere il lato più corto di almeno 256 pixel, il lato più lungo non superiore a 4,096 pixel e una risoluzione non superiore a 16 megapixel. Usa questi riferimenti oppure uno stile salvato compatibile, senza combinarli. Per la generazione basata su riferimenti di stile, la corrispondenza flexible consente un’interpretazione più libera, mentre precise segue più fedelmente resa, palette, composizione e illuminazione.

Un brief vettoriale utile definisce tipo di grafica, logica delle forme, palette, trattamento delle linee e disposizione prima di aggiungere dettagli decorativi. Per l’emblema di un negozio di giardinaggio, richiedi la silhouette di un singolo germoglio, geometria arrotondata, due colori piatti e una composizione centrata. Per il lettering, includi la parola esatta e descrivine gerarchia e forma, quindi esamina l’SVG restituito per verificare controforme leggibili, spaziatura e chiarezza a piccole dimensioni. Gli esempi vettoriali del produttore supportano tipografia espressiva e illustrazione; non garantiscono che ogni lettera o tracciato generato sia già un’opera finita.

Recraft documenta un flusso separato da immagine a immagine per i modelli raster e vettoriali V4.1. Combina un’immagine esistente e un prompt, con strength da 0 a 1 che controlla quanto il nuovo risultato si discosta dall’originale. Valori più bassi restano più vicini e valori più alti consentono cambiamenti maggiori. Questa operazione non accetta controlli di stile personalizzato V4/V4.1: trasformazione dell’immagine sorgente e generazione basata su riferimenti di stile devono quindi essere preparate come flussi distinti. L’input immagine può essere PNG, JPG, WebP o SVG entro i limiti documentati. Per la trasformazione da immagine a immagine, fornisci PNG, JPG, WebP o SVG sotto 20 MB, non oltre 16 megapixel, con entrambi i lati tra 256 e 4,096 pixel.

V4.1 non supporta nomi di stili predefiniti né i controlli negative_prompt, text_layout, artistic_level o no_text. Specifica disposizione e scritte desiderate nel brief positivo invece di affidarti ai precedenti meccanismi V3. Per un elemento di marca dettagliato, usa l’SVG come file di lavoro, esamina la geometria e adatta colori o forme secondo necessità prima di inserirlo nel layout finale. Questa edizione Pro Vector mantiene la propria identità; non è intercambiabile con le varianti raster standard o Utility soltanto perché condividono il nome V4.1.

Tramite Ailoot, seleziona questo esatto ID del modello in /v1/images/generations e fornisci il prompt creativo. Conserva ogni voce data restituita, sia che la risposta contenga un URL sia che contenga dati immagine codificati, e salva i byte effettivi con il tipo di contenuto restituito. Mantieni usage e l’eventuale task_id multimediale insieme al file, quindi verifica forme, scritte e aree di colore nel progetto previsto.

Disponibile in Ailoot · input e metodi

Ailoot Ultra · Images POST /v1/images/generations
Tipi di input
text, image
Tipi di output
image
Formato di output
File immagine
CampoTipoRequisitoValori e limitiPredefinito
CampomodelTipostringRequisitoObbligatorioValori e limiti
recraft/recraft-v4.1-pro-vector
Condizioni: Usa esattamente questo selettore di instradamento di Ailoot.
Predefinito—
CampopromptTipostringRequisitoObbligatorioValori e limiti
Condizioni:
Predefinito—
CamponTipointegerRequisitoFacoltativoValori e limiti
Minimo: 1
Massimo: 6
Condizioni:
Predefinito—
Campoaspect_ratioTipostringRequisitoFacoltativoValori e limiti
1:1, 4:3, 3:4, 16:9, 9:16, auto
Condizioni:
Predefinito—
Campooutput_formatTipostringRequisitoFacoltativoValori e limiti
svg
Condizioni:
Predefinito—
Campoinput_referencesTipoarrayRequisitoFacoltativoValori e limiti
Condizioni:
Predefinito—
CampoqualityTipostringRequisitoFacoltativoValori e limiti
auto, low, medium, high, xhigh, max
Condizioni:
Predefinito—
Combinazioni di materiali in input

Da testo a immagine

Parametri e ciclo di vita del metodo
ParametroContratto
Parametrocontent_typeContrattoapplication/json
ParametrorequiredContrattomodel, prompt
ParametrooptionalContratton, aspect_ratio, output_format, input_references, quality
Parametromaterial_typesContrattotext, image
ParametroconditionsContrattoUsa esattamente questo selettore di instradamento di Ailoot., quality è un controllo comune documentato; i fornitori che non offrono una regolazione della qualità lo ignorano. Non si promette un miglioramento della qualità per ogni modello.

Ciclo di vita: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Il task_id effettivamente restituito o il record selezionato della libreria; operation_id è un identificatore distinto.

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Tariffe

Calcolo del costo finale

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.

Modalità rapida
Non specificato Quando è selezionata la modalità rapida
Modalità flex
Non specificato Quando è selezionata la modalità flex
Sforzo massimo di ragionamento
Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)

Tariffe stimate per il confronto

Prezzi per configurazione

Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.

ConfigurazioneListino delle tariffeQuantità previstaUnità di fatturazioneCosto
ConfigurazioneTariffe base dei tokenListino delle tariffeTariffa baseQuantità 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
Configurazioneimmagine in uscitaListino delle tariffe—Quantità prevista—Unità di fatturazioneper immagine in outputCosto
Output · immagine in uscita · Stima solo a fini di confronto $0.6 per immagine in output
ConfigurazioneCosto stimato della generazioneListino delle tariffe—Quantità previstastima per una generazioneUnità di fatturazione—Costo
Output · Costo di generazione stimato · Stima solo a fini di confronto $0.6 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 →

Esempi di richieste

Ailoot Ultra · Images

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=json.loads('{"model": "recraft/recraft-v4.1-pro-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field."}')\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\n# Submit once. Retain the complete result, original identifiers and every response header.\n

Ricevi e salva i risultati

Ailoot Ultra · Images

Scarica ogni immagine restituita o salvane il contenuto Base64

Conserva tutti i risultati completati

Salva ogni immagine completata; recupera ogni URL restituito oppure decodificane il contenuto Base64.

Conserva la risposta completa e le intestazioni, gli identificatori originali, ogni risultato effettivo e tutti i campi di utilizzo e contabilizzazione. Salva ogni risorsa univoca di tua proprietà e conserva ogni ruolo che vi fa riferimento.

Se occorre verificare la risposta originale

Conserva l’X-Client-Request-ID originale, la risposta e le intestazioni. Un esito sconosciuto o result_pending_check non autorizza una seconda creazione.

Campi della risposta
CampoTipo
Campodata[].urlTipostring
Campodata[].b64_jsonTipostring
CampousageTipoobject
Errori e passaggi successivi
RispostaCondizionePassaggio successivo
Risposta400 · invalid_request_errorCondizioneUn campo obbligatorio, il selettore del modello, il tipo o la rappresentazione dei dati in ingresso non è valido.Passaggio successivoEsamina i dettagli di validazione restituiti prima di preparare una richiesta separata.
RispostaCondizioneLa richiesta originale o il relativo risultato è sconosciuto o richiede una verifica.Passaggio successivoConserva gli identificatori e le intestazioni originali; consulta solo i record di stato o della libreria supportati. Non inviare di nuovo la richiesta di creazione.

Alias

Alias del modello

Ailoot Ultra recraft/recraft-v4.1-pro-vector

Alias dei percorsi dei metodi

Usa i percorsi dei metodi indicati sopra.

ID di chiamata correlati

recraft/recraft-v4.1-pro-vector

", "method_identity": { "effective_request_model_id": "recraft/recraft-v4.1-pro-vector", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "recraft/recraft-v4.1-pro-vector", "route_label": "Ultra" }, "method_key": "Ultra|images|/v1/images/generations|recraft%2Frecraft-v4.1-pro-vector", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response and headers, original identifiers, every actual output and all usage/accounting fields. Save each unique owned asset and retain every role pointing to it.", "authentication": { "header": "Authorization", "scheme": "Bearer", "value": "$AILOOT_API_KEY" }, "control_semantics": { "other_documented_controls": "Source generic image parsing preserves request JSON. Additional documented controls stay subject to the exact model; missing DTO fields do not create Source refusals.", "quality": "The saved common image schema documents this control and says providers without a quality knob ignore it.", "style": "Selected generic Source passes JSON fields through but the saved dedicated image request schema does not declare a style field. Its omission here is not a Source ban or a supported per-model promise." }, "errors": [ { "condition": "Un campo obbligatorio, il selettore del modello, il tipo o la rappresentazione dei dati in ingresso non è valido.", "http_status": 400, "recovery": "Esamina i dettagli di validazione restituiti prima di preparare una richiesta separata.", "type": "invalid_request_error" }, { "condition": "La richiesta originale o il relativo risultato è sconosciuto o richiede una verifica.", "http_status": null, "recovery": "Conserva gli identificatori e le intestazioni originali; consulta solo i record di stato o della libreria supportati. Non inviare di nuovo la richiesta di creazione.", "type": null } ], "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned signed URL; never construct a token." }, "status": [ { "http": "GET", "id_source": "actual returned task_id or selected library record; operation_id is a separate identifier", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Conserva l’X-Client-Request-ID originale, la risposta e le intestazioni. Un esito sconosciuto o result_pending_check non autorizza una seconda creazione.", "unknown_no_replay": true }, "material_combinations": [ { "materials": [ "text", "image" ], "metadata_authority": "saved_model_discovery_union", "mode": "text_to_image", "reference_maximum": 1, "reference_minimum": 0 } ], "model_parameter_metadata": { "authority": "saved_model_discovery_union", "defaults_not_inferred": { "aspect_ratio": null, "exact_pixels": null, "explanation": "No universal/model default inferred. Omitted output_format uses provider default; dimensions are provider-derived, observed Ming2048 is not a universal default.", "n": null, "output_format": null, "quality": null, "resolution": null }, "known_parameter_choices": { "aspect_ratio": { "type": "enum", "values": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ] }, "input_references": { "max": 1, "min": 0, "type": "range" }, "n": { "max": 6, "min": 1, "type": "range" }, "output_format": { "type": "enum", "values": [ "svg" ] } }, "pointer": "/profiles/36", "scope": "Exact saved model metadata. Discovery unions are identified explicitly and are not represented as definitive selected-provider bounds." }, "outputs": { "all_results": "Conserva la risposta completa e le intestazioni, gli identificatori originali, ogni risultato effettivo e tutti i campi di utilizzo e contabilizzazione. Salva ogni risorsa univoca di tua proprietà e conserva ogni ruolo che vi fa riferimento.", "documented_formats": [ "svg" ], "every_actual_output": true, "family": "image", "fields": [ { "name": "data[].url", "type": "string" }, { "name": "data[].b64_json", "type": "string" }, { "name": "usage", "type": "object" } ], "format": "The exact saved model metadata lists SVG. Preserve the actual returned MIME and unchanged vector bytes; keep every actual output and owned signed image link." }, "parameters": [ { "conditions": "Usa esattamente questo selettore di instradamento di Ailoot.", "default_known": false, "enum": [ "recraft/recraft-v4.1-pro-vector" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "name": "prompt", "required": true, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "maximum": 6, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "conditions": "", "default_known": false, "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "conditions": "", "default_known": false, "enum": [ "svg" ], "enum_known": true, "name": "output_format", "required": false, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 1, "minItems": 0, "name": "input_references", "required": false, "type": "array" }, { "conditions": "", "default_known": false, "enum": [ "auto", "low", "medium", "high", "xhigh", "max" ], "enum_known": true, "name": "quality", "required": false, "type": "string" } ], "request_schema": { "additionalProperties": true, "properties": { "aspect_ratio": { "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "type": "string" }, "input_references": { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 1, "minItems": 0, "type": "array" }, "model": { "enum": [ "recraft/recraft-v4.1-pro-vector" ], "type": "string" }, "n": { "maximum": 6, "minimum": 1, "type": "integer" }, "output_format": { "enum": [ "svg" ], "type": "string" }, "prompt": { "type": "string" }, "quality": { "enum": [ "auto", "low", "medium", "high", "xhigh", "max" ], "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "recraft/recraft-v4.1-pro-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field." }, "content_type": "application/json", "example_is_offline_content": true }, "usage": { "meter": "Use the accepted method price and actual recorded usage; the request reserve is an estimate. A billing unit does not add an input capability.", "preserve": "Keep all returned usage, accounting and request identifiers with every actual output.", "settlement": "Retain the original operation; reconcile its result and accounting once." } }, "input": { "conditions": [ "Usa esattamente questo selettore di instradamento di Ailoot.", "quality è un controllo comune documentato; i fornitori che non offrono una regolazione della qualità lo ignorano. Non si promette un miglioramento della qualità per ogni modello." ], "content_type": "application/json", "material_types": [ "text", "image" ], "optional": [ "n", "aspect_ratio", "output_format", "input_references", "quality" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned signed URL; never construct a token." }, "status": [ { "http": "GET", "id_source": "Il task_id effettivamente restituito o il record selezionato della libreria; operation_id è un identificatore distinto.", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Keep the original X-Client-Request-ID, response and headers. An unknown or result_pending_check outcome does not authorize a second creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "output": { "all_results": "Retain the complete response and headers, original identifiers, every actual output and all usage/accounting fields. Save each unique owned asset and retain every role pointing to it.", "documented_formats": [ "svg" ], "every_actual_output": true, "family": "image", "fields": [ { "name": "data[].url", "type": "string" }, { "name": "data[].b64_json", "type": "string" }, { "name": "usage", "type": "object" } ], "format": "The saved exact model metadata lists SVG. Preserve actual MIME and bytes; storage MIME support alone does not prove completion of the full selected generic output path." } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per output image" }, "label": "output image", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Costo stimato della generazione", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "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=json.loads('{\"model\": \"recraft/recraft-v4.1-pro-vector\", \"prompt\": \"A portrait of an Asian woman with neon green lights in the background, shallow depth of field.\"}')\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\n# Submit once. Retain the complete result, original identifiers and every response header.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "images", "http": "POST", "in": null, "input": [ "text", "image" ], "input_conditions": { "image": "Use the exact model reference-input range in the saved model metadata; a reference becomes required only for the models whose listed minimum is positive." }, "label": "Images", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "image" ], "path": "/v1/images/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per output image" }, "label": "output image", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "recraft/recraft-v4.1-pro-vector", "route_label": "Ultra", "status_reads": [ "GET /v1/media/tasks/{task_id}" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" }, { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "recraft/recraft-v4.1-pro-vector", "nativeProvenance": { "input_facts_canonical_sha256": "6d9b94454294a36ae7c46b1876bc93e0b1cb63763279efcc63796835c70ad61c", "input_html_sha256": "e8bf0633545c15770655fd9f26af3c9e26a295027602609d5e774e9a2f4c1fc6", "private_audit_sha256": "d9ce309ce700001053152911b7d2d7ff74270169de9c2ea9e3e1d768d7d3b7c7", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/it/recraft-recraft-v4-1-pro-vector/", "description": "Recraft V4.1 Pro Vector crea grafica SVG modificabile per loghi, lettering e illustrazioni dettagliate. È l’edizione vettoriale Pro della famiglia V4.1, che combina prompt testuali con input facoltativi di immagini e stili mantenendo un risultato vettoriale.", "locale": "it", "md_url": "https://ailoot.ai/models/it/recraft-recraft-v4-1-pro-vector/index.md", "title": "Recraft: Recraft V4.1 Pro Vector — Ailoot", "url": "https://ailoot.ai/models/it/recraft-recraft-v4-1-pro-vector/" }, "rawModel": { "about": "Recraft V4.1 Pro Vector è l’edizione SVG Pro della famiglia V4.1 di generazione di immagini di Recraft. È progettata per lavori il cui risultato deve rimanere grafica vettoriale modificabile: un logo, un concetto tipografico, un’icona o un’illustrazione. La presentazione V4.1 del produttore sottolinea composizione e illustrazione intenzionali, mentre la documentazione esatta del modello identifica questa variante separatamente dalle edizioni Vector standard, Pro raster e Utility. La sua immagine finale è un SVG anziché un’esportazione raster ad alta risoluzione.\n\nIl codice del modello del produttore è recraftv4_1_pro_vector. L’output vettoriale non ha dimensioni fisse in pixel; la documentazione sulle dimensioni accetta quattordici rapporti larghezza/altezza per i modelli vettoriali e non accetta dimensioni esatte in pixel. Le impostazioni raster 2K di Pro non definiscono quindi la risoluzione SVG di questa edizione. Specifica le proporzioni desiderate e come verrà usata la grafica. Per un logo, il risultato importante è una silhouette leggibile e aree di colore modificabili che possano essere adattate in un flusso di design.\n\nIl modello supporta generazione da testo a immagine e riferimenti facoltativi di stile personalizzato. Il limite documentato del prompt è di 10,000 caratteri. Colori preferiti, un colore di sfondo desiderato e un seed casuale possono guidare la generazione e il flusso consente da uno a sei output. Uno stile salvato compatibile o immagini di riferimento possono stabilire un linguaggio visivo; lo stile deve corrispondere al modello per cui è stato creato. La linea principale V4.1 non richiede uno stile di riferimento in ogni richiesta, a differenza della famiglia dedicata V4 Styles. Per la generazione basata su riferimenti di stile, usa da una a dieci immagini PNG, JPG o WebP, per un totale non superiore a 64 MB e meno di 20 MB ciascuna. Ogni riferimento deve avere il lato più corto di almeno 256 pixel, il lato più lungo non superiore a 4,096 pixel e una risoluzione non superiore a 16 megapixel. Usa questi riferimenti oppure uno stile salvato compatibile, senza combinarli. Per la generazione basata su riferimenti di stile, la corrispondenza flexible consente un’interpretazione più libera, mentre precise segue più fedelmente resa, palette, composizione e illuminazione.\n\nUn brief vettoriale utile definisce tipo di grafica, logica delle forme, palette, trattamento delle linee e disposizione prima di aggiungere dettagli decorativi. Per l’emblema di un negozio di giardinaggio, richiedi la silhouette di un singolo germoglio, geometria arrotondata, due colori piatti e una composizione centrata. Per il lettering, includi la parola esatta e descrivine gerarchia e forma, quindi esamina l’SVG restituito per verificare controforme leggibili, spaziatura e chiarezza a piccole dimensioni. Gli esempi vettoriali del produttore supportano tipografia espressiva e illustrazione; non garantiscono che ogni lettera o tracciato generato sia già un’opera finita.\n\nRecraft documenta un flusso separato da immagine a immagine per i modelli raster e vettoriali V4.1. Combina un’immagine esistente e un prompt, con strength da 0 a 1 che controlla quanto il nuovo risultato si discosta dall’originale. Valori più bassi restano più vicini e valori più alti consentono cambiamenti maggiori. Questa operazione non accetta controlli di stile personalizzato V4/V4.1: trasformazione dell’immagine sorgente e generazione basata su riferimenti di stile devono quindi essere preparate come flussi distinti. L’input immagine può essere PNG, JPG, WebP o SVG entro i limiti documentati. Per la trasformazione da immagine a immagine, fornisci PNG, JPG, WebP o SVG sotto 20 MB, non oltre 16 megapixel, con entrambi i lati tra 256 e 4,096 pixel.\n\nV4.1 non supporta nomi di stili predefiniti né i controlli negative_prompt, text_layout, artistic_level o no_text. Specifica disposizione e scritte desiderate nel brief positivo invece di affidarti ai precedenti meccanismi V3. Per un elemento di marca dettagliato, usa l’SVG come file di lavoro, esamina la geometria e adatta colori o forme secondo necessità prima di inserirlo nel layout finale. Questa edizione Pro Vector mantiene la propria identità; non è intercambiabile con le varianti raster standard o Utility soltanto perché condividono il nome V4.1.\n\nTramite Ailoot, seleziona questo esatto ID del modello in /v1/images/generations e fornisci il prompt creativo. Conserva ogni voce data restituita, sia che la risposta contenga un URL sia che contenga dati immagine codificati, e salva i byte effettivi con il tipo di contenuto restituito. Mantieni usage e l’eventuale task_id multimediale insieme al file, quindi verifica forme, scritte e aree di colore nel progetto previsto.", "alias_of": null, "aliases": [], "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Tutte le tariffe della configurazione sono riportate nei dettagli." } ], "ctx": null, "formats": [ "images" ], "id": "recraft/recraft-v4.1-pro-vector", "input": [ "text", "image" ], "kind": "image", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Retain the complete response and headers, original identifiers, every actual output and all usage/accounting fields. Save each unique owned asset and retain every role pointing to it.", "authentication": { "header": "Authorization", "scheme": "Bearer", "value": "$AILOOT_API_KEY" }, "control_semantics": { "other_documented_controls": "Source generic image parsing preserves request JSON. Additional documented controls stay subject to the exact model; missing DTO fields do not create Source refusals.", "quality": "The saved common image schema documents this control and says providers without a quality knob ignore it.", "style": "Selected generic Source passes JSON fields through but the saved dedicated image request schema does not declare a style field. Its omission here is not a Source ban or a supported per-model promise." }, "errors": [ { "condition": "Un campo obbligatorio, il selettore del modello, il tipo o la rappresentazione dei dati in ingresso non è valido.", "http_status": 400, "recovery": "Esamina i dettagli di validazione restituiti prima di preparare una richiesta separata.", "type": "invalid_request_error" }, { "condition": "La richiesta originale o il relativo risultato è sconosciuto o richiede una verifica.", "http_status": null, "recovery": "Conserva gli identificatori e le intestazioni originali; consulta solo i record di stato o della libreria supportati. Non inviare di nuovo la richiesta di creazione.", "type": null } ], "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned signed URL; never construct a token." }, "status": [ { "http": "GET", "id_source": "actual returned task_id or selected library record; operation_id is a separate identifier", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Conserva l’X-Client-Request-ID originale, la risposta e le intestazioni. Un esito sconosciuto o result_pending_check non autorizza una seconda creazione.", "unknown_no_replay": true }, "material_combinations": [ { "materials": [ "text", "image" ], "metadata_authority": "saved_model_discovery_union", "mode": "text_to_image", "reference_maximum": 1, "reference_minimum": 0 } ], "model_parameter_metadata": { "authority": "saved_model_discovery_union", "defaults_not_inferred": { "aspect_ratio": null, "exact_pixels": null, "explanation": "No universal/model default inferred. Omitted output_format uses provider default; dimensions are provider-derived, observed Ming2048 is not a universal default.", "n": null, "output_format": null, "quality": null, "resolution": null }, "known_parameter_choices": { "aspect_ratio": { "type": "enum", "values": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ] }, "input_references": { "max": 1, "min": 0, "type": "range" }, "n": { "max": 6, "min": 1, "type": "range" }, "output_format": { "type": "enum", "values": [ "svg" ] } }, "pointer": "/profiles/36", "scope": "Exact saved model metadata. Discovery unions are identified explicitly and are not represented as definitive selected-provider bounds." }, "outputs": { "all_results": "Conserva la risposta completa e le intestazioni, gli identificatori originali, ogni risultato effettivo e tutti i campi di utilizzo e contabilizzazione. Salva ogni risorsa univoca di tua proprietà e conserva ogni ruolo che vi fa riferimento.", "documented_formats": [ "svg" ], "every_actual_output": true, "family": "image", "fields": [ { "name": "data[].url", "type": "string" }, { "name": "data[].b64_json", "type": "string" }, { "name": "usage", "type": "object" } ], "format": "The exact saved model metadata lists SVG. Preserve the actual returned MIME and unchanged vector bytes; keep every actual output and owned signed image link." }, "parameters": [ { "conditions": "Usa esattamente questo selettore di instradamento di Ailoot.", "default_known": false, "enum": [ "recraft/recraft-v4.1-pro-vector" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "name": "prompt", "required": true, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "maximum": 6, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "conditions": "", "default_known": false, "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "enum_known": true, "name": "aspect_ratio", "required": false, "type": "string" }, { "conditions": "", "default_known": false, "enum": [ "svg" ], "enum_known": true, "name": "output_format", "required": false, "type": "string" }, { "conditions": "", "default_known": false, "enum_known": false, "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 1, "minItems": 0, "name": "input_references", "required": false, "type": "array" }, { "conditions": "", "default_known": false, "enum": [ "auto", "low", "medium", "high", "xhigh", "max" ], "enum_known": true, "name": "quality", "required": false, "type": "string" } ], "request_schema": { "additionalProperties": true, "properties": { "aspect_ratio": { "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "auto" ], "type": "string" }, "input_references": { "items": { "properties": { "image_url": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, "maxItems": 1, "minItems": 0, "type": "array" }, "model": { "enum": [ "recraft/recraft-v4.1-pro-vector" ], "type": "string" }, "n": { "maximum": 6, "minimum": 1, "type": "integer" }, "output_format": { "enum": [ "svg" ], "type": "string" }, "prompt": { "type": "string" }, "quality": { "enum": [ "auto", "low", "medium", "high", "xhigh", "max" ], "type": "string" } }, "required": [ "model", "prompt" ], "type": "object" }, "schema_template": { "actual_file_preparation_required": false, "body": { "model": "recraft/recraft-v4.1-pro-vector", "prompt": "A portrait of an Asian woman with neon green lights in the background, shallow depth of field." }, "content_type": "application/json", "example_is_offline_content": true }, "usage": { "meter": "Use the accepted method price and actual recorded usage; the request reserve is an estimate. A billing unit does not add an input capability.", "preserve": "Keep all returned usage, accounting and request identifiers with every actual output.", "settlement": "Retain the original operation; reconcile its result and accounting once." } }, "input": { "conditions": [ "Usa esattamente questo selettore di instradamento di Ailoot.", "quality è un controllo comune documentato; i fornitori che non offrono una regolazione della qualità lo ignorano. Non si promette un miglioramento della qualità per ogni modello." ], "content_type": "application/json", "material_types": [ "text", "image" ], "optional": [ "n", "aspect_ratio", "output_format", "input_references", "quality" ], "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "cancel_endpoint": null, "create": { "http": "POST", "path": "/v1/images/generations" }, "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "owned_content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "Use the exact returned signed URL; never construct a token." }, "status": [ { "http": "GET", "id_source": "Il task_id effettivamente restituito o il record selezionato della libreria; operation_id è un identificatore distinto.", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "Keep the original X-Client-Request-ID, response and headers. An unknown or result_pending_check outcome does not authorize a second creation.", "unknown_no_replay": true }, "method": { "http": "POST", "path": "/v1/images/generations" }, "method_aliases": [], "output": { "all_results": "Retain the complete response and headers, original identifiers, every actual output and all usage/accounting fields. Save each unique owned asset and retain every role pointing to it.", "documented_formats": [ "svg" ], "every_actual_output": true, "family": "image", "fields": [ { "name": "data[].url", "type": "string" }, { "name": "data[].b64_json", "type": "string" }, { "name": "usage", "type": "object" } ], "format": "The saved exact model metadata lists SVG. Preserve actual MIME and bytes; storage MIME support alone does not prove completion of the full selected generic output path." } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per output image" }, "label": "output image", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Costo stimato della generazione", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "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=json.loads('{\"model\": \"recraft/recraft-v4.1-pro-vector\", \"prompt\": \"A portrait of an Asian woman with neon green lights in the background, shallow depth of field.\"}')\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\n# Submit once. Retain the complete result, original identifiers and every response header.\n", "label": "curl · create once and retain the complete result", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "images", "http": "POST", "in": null, "input": [ "text", "image" ], "input_conditions": { "image": "Use the exact model reference-input range in the saved model metadata; a reference becomes required only for the models whose listed minimum is positive." }, "label": "Images", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "image" ], "path": "/v1/images/generations", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "quoted_unit": "per output image" }, "label": "output image", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "recraft/recraft-v4.1-pro-vector", "route_label": "Ultra", "status_reads": [ "GET /v1/media/tasks/{task_id}" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "image_output", "label": "output image", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "per output image", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "image_output" }, { "amount": "0.6", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.6", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "recraft/recraft-v4.1-pro-vector", "request_model_id": "recraft/recraft-v4.1-pro-vector", "route_label": "Ultra" } ], "name": "Recraft: Recraft V4.1 Pro Vector", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.6, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.6, "varies": false }, "short": "Recraft V4.1 Pro Vector crea grafica SVG modificabile per loghi, lettering e illustrazioni dettagliate. È l’edizione vettoriale Pro della famiglia V4.1, che combina prompt testuali con input facoltativi di immagini e stili mantenendo un risultato vettoriale.", "title": "Recraft: Recraft V4.1 Pro Vector" }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "Recraft V4.1 Pro Vector crea grafica SVG modificabile per loghi, lettering e illustrazioni dettagliate. È l’edizione vettoriale Pro della famiglia V4.1, che combina prompt testuali con input facoltativi di immagini e stili mantenendo un risultato vettoriale.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "99ef59f3a65cf9acc6df4cd61aff6090e618afb38f69340069aabc1e08c94497", "renderer_sha256": "3be1a96012c3c76b38a7b9bea6a57c0def38c56103737bee6a5e77aaa75e488a" }, "sourceRevision": "300ce1b99924af192e28de6c967da946e0fd9d460f2de4395b0bfab893676066" }