API

Introducción

Generar imagen

Crea una o más imágenes a partir de una descripción en lenguaje natural utilizando un modelo de imagen NovaAI.

POST
https://api.novaai.com/v1/images/generations

Authentication

Send a project-scoped NovaAI API key in the Authorization header using the Bearer scheme. Requests without valid credentials return 401 Unauthorized.

Authorization

string

requerido

Request properties

model

string

requerido

Image generation model identifier.

prompt

string

requerido

Detailed text description of the desired output.

size

string

opcional

Requested output dimensions supported by the selected model.

Response behavior

A successful POST request returns a structured NovaAI resource response. Validate the returned identifier before persisting it, and handle 400 Bad Request for malformed input or 401 Unauthorized for invalid project credentials.

Integration notes

Use POST /v1/images/generations from a trusted server environment. Keep your NovaAI API key out of browser bundles and pass only the data required for generate image in each request.

Validate inputs before sending the request, log the returned request identifier for troubleshooting, and use exponential backoff for temporary failures or rate-limit responses. Treat malformed payloads and authorization failures as non-retryable until corrected.

Error handling

Inspect the error type and code returned by NovaAI before retrying. Correct invalid parameters for 400 responses, refresh or replace credentials for 401 responses, and wait before retrying requests that are temporarily limited.

POST/v1/images/generations
POST /v1/images/generations HTTP/1.1
Authorization: Bearer NOVA_API_KEY
Content-Type: application/json
200Success response
{
"id": "generate_image_01",
"object": "nova.resource",
"status": "succeeded"
}
400Invalid request
{
"error": {
"message": "Invalid request",
"type": "invalid_request_error",
"code": "invalid_parameter"
}
}

Create a free website with Framer, the website builder loved by startups, designers and agencies.