Skip to main content

​
1. Generate an API Key

Get your API key from the Legnext dashboard to authenticate your requests.
Never share your API key with anyone. Keep it secure and never commit it to version control.

​
2. Set URL and Endpoint

All API requests are made to our base URL with specific endpoints: 
https://api.legnext.ai/api/v1/{endpoint}
For example: https://api.legnext.ai/api/v1/diffusion

​
3. Headers

All API requests must include the following headers:
HeaderRequiredDescription
x-api-keyYesYour API key for authentication
Content-TypeNoSet to application/json

​
4. Make Your First API Call

Generate your first image using our text-to-image endpoint: 
curl -X POST "https://api.legnext.ai/api/v1/diffusion" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "A beautiful sunset over mountains with vibrant colors",
    "callback": "https://your-domain.com/webhook"
  }'

​
5. Response Format

All endpoints return a Job object containing:
  • job_id: Unique job identifier
  • status: Processing status (pending, processing, completed, failed)
  • output: Contains result image URLs when completed
  • meta: Usage and timing information
  • error: Error details if task failed

​
6. Error Codes & Handling

When a request fails, the API returns an HTTP error status code along with an error object: 
{
  "code": 401,
  "message": "Failed to verify api key",
  "raw_message": "",
  "detail": null
}

​
HTTP Status Codes

CodeDescriptionSolution
400Bad RequestInvalid request parameters or malformed request body. Check your input parameters
401UnauthorizedAuthentication failed. Verify your API key is valid and included in the x-api-key header
402Payment RequiredInsufficient credits in your account. Top up your balance or upgrade your plan
403ForbiddenSensitive content detected or permission denied. Review content policy guidelines
413Payload Too LargeFile size exceeds maximum limit. Reduce file size and try again
422Unprocessable EntityInvalid parameter values or validation failed. Check parameter formats and values
429Too Many RequestsRate limit exceeded. Reduce request frequency or upgrade your plan
500Internal Server ErrorTemporary server issue. The request will be automatically retried
All error responses include a code field matching the HTTP status code and a message field with a human-readable description. Check these fields to understand what went wrong.

​
7. Next Steps

Start exploring our powerful image generation capabilities!

​
Important

Please read our Notice before using the API to understand supported models and current limitations.