Azurade AI Prompts API

openapi: 3.2.0
info:
  contact:
    email: support@azurade.com
    name: Azurade AI support
  description: 'Image and video generation, prompt tools and account access for Azurade AI.


    Credits: one balance per account, shared with the web app, same prices. Credits do not expire and are not reset by any billing cycle. A failed generation is refunded automatically. Prices are in credits; the model catalogue carries the price of a default request and POST /api/v2/generations/estimate the exact price of a specific one.


    Errors: every non-2xx body is {"error": , "code": }. Codes worth handling: unknown_model, validation_failed, insufficient_credits (402; POST /api/v2/checkout returns a link for the account holder to buy more), prompt_rejected (400, revise the prompt, do not retry it unchanged), moderation_unavailable and enhance_unavailable (503, safe to retry), generation_failed (502, the job could not be started and nothing was charged; its id is in the body and GET /api/v2/generations/{id} carries the reason), not_found (404, also for records that belong to another account).


    Generations are asynchronous: POST answers 202 with an id, GET /api/v2/generations/{id} moves from pending to completed or failed, and completed carries the output files. The files are attached a moment after the status turns completed, so poll until status is failed, or completed with a non-empty outputs array.'
  title: Azurade AI Prompts API
  version: '2'
servers:
- url: https://azurade.com
tags:
- description: Rewrite a prompt for a model, or screen one against the content policy, without generating.
  name: Prompts
paths:
  /api/v2/prompts/enhance:
    post:
      description: 'Expands a short prompt into a detailed one, using the target model''s own prompting guide when a model is given. Costs 1 credit. The same rewrite is free when requested inside a generation with enhance_prompt: true.'
      operationId: enhancePrompt
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EnhanceRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EnhanceResult'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Invalid request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Missing or invalid credentials
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Insufficient credits
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: A dependency is unavailable; retry later
      security:
      - ApiKeyAuth: []
      - SessionAuth: []
      summary: Rewrite a prompt for a model
      tags:
      - Prompts
  /api/v2/prompts/moderate:
    post:
      description: Runs the content-policy screen a generation would run and returns the decision (allow, deny) without generating. Costs 1 credit.
      operationId: moderatePrompt
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ModerateRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModerateResult'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Invalid request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Missing or invalid credentials
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Insufficient credits
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: A dependency is unavailable; retry later
      security:
      - ApiKeyAuth: []
      - SessionAuth: []
      summary: Screen a prompt
      tags:
      - Prompts
components:
  schemas:
    EnhanceRequest:
      additionalProperties: false
      properties:
        model:
          description: Use this model's prompting guide; sets type
          enum:
          - flux-dev
          - flux-kontext-pro
          - gpt-image-2
          - gpt-image-2.5
          - hunyuan
          - imagen-4-ultra
          - kling-3.0
          - kling-3.0-turbo
          - motion-control
          - nano-banana
          - nano-banana-2
          - nano-banana-2-lite
          - nano-banana-2.1
          - nano-banana-pro
          - qwen-image
          - qwen-image-2.1
          - qwen-image-edit
          - qwen-image-edit-plus
          - qwen-image-edit-plus-lora
          - qwen-image-layered
          - recraft-crisp-upscale
          - remove-background
          - restore-image
          - seedance-2
          - seedance-2-mini
          - seedance-2.5
          - seedance-pro
          - seedream-3
          - seedream-4
          - seedream-4.5
          - seedream-5-flash
          - seedream-5-lite
          - seedream-5-pro
          - veo2
          - veo3
          - veo3-fast
          - veo3.1
          - vidu-q4
          - vidu-q4-reference
          - wan-2.2
          - wan-2.6
          - wan-2.7
          - wan-2.7-image
          - wan-3.0
          - wan-3.0-prime
          type: string
        prompt:
          maxLength: 10000
          type: string
        type:
          description: image when omitted; ignored when model is set
          enum:
          - image
          - video
          type: string
      required:
      - prompt
      type: object
    Error:
      properties:
        balance:
          type: number
        code:
          type: string
        cost:
          type: number
        error:
          type: string
        id:
          description: The failed generation, on generation_failed
          type: string
      required:
      - error
      - code
      type: object
    ModerateRequest:
      additionalProperties: false
      properties:
        prompt:
          maxLength: 10000
          type: string
      required:
      - prompt
      type: object
    EnhanceResult:
      properties:
        balance:
          description: Your credits after the charge
          type: number
        cost:
          type: number
        model:
          type: string
        prompt:
          type: string
        type:
          type: string
      type: object
    ModerateResult:
      properties:
        balance:
          description: Your credits after the charge
          type: number
        cost:
          type: number
        decision:
          enum:
          - allow
          - deny
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      bearerFormat: sk-...
      description: 'API key as `Authorization: Bearer sk-...`. The same secret is also accepted in an `X-API-Key` header, with or without the `Bearer ` prefix. Keys are created and deleted on the profile page; a key signs the routes in this document, can revoke itself at /api/oauth/revoke, and cannot create keys, delete other keys or change the account. It can start a checkout, which only a person paying by card completes.'
      scheme: bearer
      type: http
    SessionAuth:
      description: PocketBase session token, as issued to the web app.
      in: header
      name: Authorization
      type: apiKey