Access & discovery

List models

Read the public catalog of supported models, input schemas, limits and current credit prices.

Endpoint

GET/api/v1/developer/models

Authentication & scope

Public endpoint; no bearer required.

No bearer is required. Use exact model_key, operations and input_schema values from this response. Availability and pricing can change; missing prices must not be guessed.

Request parameters

No request body or query parameters.

curl --request GET \
  --url 'https://api.perchanceai.art/api/v1/developer/models' \
  --header 'X-App-Id: perchanceai' \
  --header 'X-Request-Id: docs-example'

Response HTTP 200

Illustrative response shape, not a live API response. Example numbers and USD do not imply fixed pricing or a cash balance. Null fields are omitted.

REST success responses contain success, code, message, request_id and data; the table describes data.

Field	Type	Required	Description
`models`	object[]	Yes	model_key, display_name, modality, operations, input_schema, description, limits, price_unit and price; nullable values are omitted.

{
  "success": true,
  "code": "OK",
  "message": "OK",
  "request_id": "docs-example",
  "data": {
    "models": [
      {
        "model_key": "<model_key_from_catalog>",
        "display_name": "Example image model",
        "modality": "image",
        "operations": [
          "image_generation"
        ],
        "input_schema": {
          "type": "object",
          "properties": {
            "prompt": {
              "type": "string"
            }
          },
          "required": [
            "prompt"
          ]
        },
        "limits": {}
      }
    ]
  }
}

Errors

This public catalog requires no authentication; other request errors use the standard REST error envelope.