OpenAI: DALL·E 3
DALL·E 3 gera imagens a partir de uma descrição escrita da cena. Utilize o ID exato do modelo openai/dall-e-3 ou o seu alias dall-e-3 com o método de geração de imagens e guarde depois todos os URLs de imagem devolvidos e o resultado que os acompanha. Um pedido inicial documentado produz uma imagem 1024x1024 a partir de texto.
- Ailoot Ultra · Images
POST /v1/images/generationsopenai/dall-e-3 - Ailoot Ultra · Images
POST /v1/images/generationsdall-e-3
Sobre o modelo
Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo.
DALL·E 3 é o modelo de texto para imagem da OpenAI. Utilize uma descrição escrita para criar uma ilustração, um conceito de cena ou uma orientação visual para um design. Descreva no prompt o tema, o ambiente, a composição, a iluminação e o tratamento visual. Por exemplo, uma descrição de conceito pode pedir uma bicicleta de entregas junto de uma pequena loja ao anoitecer, vista da rua, com um sujeito claro em primeiro plano e uma paleta de cores contida.
Envie POST /v1/images/generations com um corpo application/json. O ID público exato do modelo é openai/dall-e-3; o alias admitido dall-e-3 seleciona a mesma ficha de modelo. A estrutura inicial documentada fornece model, prompt, n:1 e size:"1024x1024". n é um número inteiro opcional e tem 1 como valor predefinido. Envie stream:false ou omita stream para obter o resultado JSON completo. Utilize um prompt de texto não vazio e mantenha este pedido focado numa descrição completa de uma imagem. O método disponibilizado é a geração de imagens a partir de texto.
Torne explícitos os requisitos importantes para o local de utilização. Uma ilustração editorial pode indicar a ideia central e os objetos que a expressam. Um conceito de cena pode especificar a posição da câmara, a hora do dia e as partes da composição que precisam de espaço em redor. Mantenha a formulação exata que deve aparecer na imagem separada das descrições da cena e inspecione depois o texto desenhado e a disposição visual antes de utilizar o resultado selecionado.
A resposta de geração é JSON com um carimbo temporal created e um array data. O elemento de resultado documentado inclui url e pode incluir revised_prompt, prompt_filter_results e content_filter_results. Preserve esses campos com a resposta completa e transfira a imagem de cada URL assinado do Ailoot devolvido. As ligações assinadas do Ailoot para ficheiros duram 24 horas a partir da emissão. Conserve o URL exato devolvido, incluindo a sua cadeia de consulta, até o ficheiro estar guardado; determine o formato da imagem guardada a partir da resposta real ou dos bytes do ficheiro.
Trate o ficheiro de imagem devolvido como o recurso de design utilizável e o JSON como o registo da geração que o acompanha. Compare a imagem com a descrição fornecida antes de a inserir numa página, apresentação ou aplicação. Se a resposta estiver incompleta ou o resultado do envio for incerto, preserve o identificador do pedido original e as informações devolvidas enquanto verifica a tentativa existente, em vez de criar outra imagem apenas para recuperar o resultado em falta. Para obter resultados guardados, utilize a mesma chave de API para GET /v1/media/assets?family=image e percorra todos os next_cursor. O ID do recurso aparece em cada URL /v1/media/assets/{asset_id}/content devolvido e no respetivo registo da biblioteca multimédia. Consulte GET /v1/media/assets/{asset_id} para cada registo selecionado e transfira o respetivo content_url exato. Se o pedido de ficheiro devolver 404 com o código link_expired, consulte novamente o mesmo recurso para obter uma ligação renovada. Renovar a ligação de um recurso não exige outro pedido de geração de imagens.
Ailoot Ultra · Images POST /v1/images/generations openai/dall-e-3
openai/dall-e-3openai/dall-e-3dall-e-3
Introdução
DALL·E 3 gera imagens a partir de uma descrição escrita da cena. Utilize o ID exato do modelo openai/dall-e-3 ou o seu alias dall-e-3 com o método de geração de imagens e guarde depois todos os URLs de imagem devolvidos e o resultado que os acompanha. Um pedido inicial documentado produz uma imagem 1024x1024 a partir de texto.
- Entradas aceites
- Texto
- Resultados
- Imagens
Disponível no Ailoot · entradas e métodos
Ailoot Ultra · Images POST /v1/images/generations
- Entrada
text- Saída
image- Formato de saída
- Ficheiro de imagem
| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites openai/dall-e-3 | Predefinição— |
Campoprompt | Tipostring | RequisitoObrigatório | Valores e limites | Predefinição— |
Campostream | Tipoboolean | RequisitoOpcional | Valores e limites false | Predefiniçãofalse |
Campon | Tipointeger | RequisitoOpcional | Valores e limites 1 | Predefinição— |
Camposize | Tipostring | RequisitoOpcional | Valores e limites 1024x1024 | Predefinição— |
Parâmetros e ciclo de vida do método
| Parâmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, prompt |
Parâmetrooptional | Contratostream, n, size |
Parâmetromaterial_types | Contratotext |
Parâmetroconditions | ContratoUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Ciclo de vida: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarifários
Cálculo do custo final
As tarifas apresentadas permitem estimar o custo antes da geração. O montante final cobrado é calculado a partir do custo registado para a geração original. A duração medida do resultado e as quantidades previstas não correspondem à quantidade final faturável.
As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado.
- Modo rápido
- Não especificado Quando o modo rápido está selecionado
- Modo flex
- Não especificado Quando o modo flex está selecionado
- Esforço máximo de raciocínio
- Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default)
Tarifas estimadas para comparação
Preços por configuração
Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.
| Configuração | Tabela de tarifas | Quantidade prevista | Custo |
|---|---|---|---|
| ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade prevista— | Custo Entrada · Tokens de entrada · Estimativa apenas para comparação — / 1K tokens Saída · Tokens de saída · Estimativa apenas para comparação — / 1K tokens Entrada · Leitura da cache · Estimativa apenas para comparação — / 1K tokens Entrada · Escrita na cache · Estimativa apenas para comparação — / 1K tokens Entrada · Escrita na cache, 1 hora · Estimativa apenas para comparação — / 1K tokens |
| ConfiguraçãoEstimated generation cost | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Custo Entrada · Custo estimado de geração · Estimativa apenas para comparação $0.32768 estimativa antes da geração This estimate is not an additional charge or a fixed rate for the completed generation. |
O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. Como funcionam a reserva e a liquidação →
Exemplos de pedidos
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "openai/dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Receber e guardar os resultados
Ailoot Ultra · Images
Descarregue cada imagem devolvida ou guarde o respetivo conteúdo Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Guardar todos os resultados concluídos
Guarde cada imagem concluída; obtenha cada URL devolvido ou descodifique o respetivo conteúdo Base64.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Se for necessário verificar a resposta original
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliases
Aliases do modelo
Ailoot Ultra openai/dall-e-3, dall-e-3
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
Ailoot Ultra · Images POST /v1/images/generations dall-e-3
dall-e-3openai/dall-e-3dall-e-3
Introdução
DALL·E 3 gera imagens a partir de uma descrição escrita da cena. Utilize o ID exato do modelo openai/dall-e-3 ou o seu alias dall-e-3 com o método de geração de imagens e guarde depois todos os URLs de imagem devolvidos e o resultado que os acompanha. Um pedido inicial documentado produz uma imagem 1024x1024 a partir de texto.
- Entradas aceites
- Texto
- Resultados
- Imagens
Disponível no Ailoot · entradas e métodos
Ailoot Ultra · Images POST /v1/images/generations
- Entrada
text- Saída
image- Formato de saída
- Ficheiro de imagem
| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites dall-e-3 | Predefinição— |
Campoprompt | Tipostring | RequisitoObrigatório | Valores e limites | Predefinição— |
Campostream | Tipoboolean | RequisitoOpcional | Valores e limites false | Predefiniçãofalse |
Campon | Tipointeger | RequisitoOpcional | Valores e limites 1 | Predefinição— |
Camposize | Tipostring | RequisitoOpcional | Valores e limites 1024x1024 | Predefinição— |
Parâmetros e ciclo de vida do método
| Parâmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, prompt |
Parâmetrooptional | Contratostream, n, size |
Parâmetromaterial_types | Contratotext |
Parâmetroconditions | ContratoUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Ciclo de vida: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarifários
Cálculo do custo final
As tarifas apresentadas permitem estimar o custo antes da geração. O montante final cobrado é calculado a partir do custo registado para a geração original. A duração medida do resultado e as quantidades previstas não correspondem à quantidade final faturável.
As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado.
- Modo rápido
- Não especificado Quando o modo rápido está selecionado
- Modo flex
- Não especificado Quando o modo flex está selecionado
- Esforço máximo de raciocínio
- Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default)
Tarifas estimadas para comparação
Preços por configuração
Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.
| Configuração | Tabela de tarifas | Quantidade prevista | Custo |
|---|---|---|---|
| ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade prevista— | Custo Entrada · Tokens de entrada · Estimativa apenas para comparação — / 1K tokens Saída · Tokens de saída · Estimativa apenas para comparação — / 1K tokens Entrada · Leitura da cache · Estimativa apenas para comparação — / 1K tokens Entrada · Escrita na cache · Estimativa apenas para comparação — / 1K tokens Entrada · Escrita na cache, 1 hora · Estimativa apenas para comparação — / 1K tokens |
| ConfiguraçãoEstimated generation cost | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Custo Entrada · Custo estimado de geração · Estimativa apenas para comparação $0.32768 estimativa antes da geração This estimate is not an additional charge or a fixed rate for the completed generation. |
O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. Como funcionam a reserva e a liquidação →
Exemplos de pedidos
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Receber e guardar os resultados
Ailoot Ultra · Images
Descarregue cada imagem devolvida ou guarde o respetivo conteúdo Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Guardar todos os resultados concluídos
Guarde cada imagem concluída; obtenha cada URL devolvido ou descodifique o respetivo conteúdo Base64.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Se for necessário verificar a resposta original
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliases
Aliases do modelo
Ailoot Ultra openai/dall-e-3, dall-e-3
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
FAQ · OpenAI: DALL·E 3
- Que entradas e resultados estão disponíveis?
POST /v1/images/generations·openai/dall-e-3:text→imagePOST /v1/images/generations·dall-e-3:text→image- Que campos utiliza o pedido?
POST /v1/images/generations·openai/dall-e-3:model,prompt,stream,n,sizePOST /v1/images/generations·dall-e-3:model,prompt,stream,n,size