Skip to main content
GET
/
api
/
v1
/
images
/
models
/
{modelId}
/
endpoints
Get Image Model Endpoints
curl --request GET \
  --url https://nano-gpt.com/api/v1/images/models/{modelId}/endpoints

​
Overview

Use GET /api/v1/images/models/{modelId}/endpoints to inspect public endpoint metadata for a specific image model. The response includes supported parameters, public NanoGPT pricing, streaming support, and image reference constraints when the model supports image inputs. For model IDs that contain slashes, use the endpoints URL returned by GET /api/v1/images/models.

​
Authentication

Authentication is optional.
  • Authorization: Bearer YOUR_API_KEY
  • x-api-key: YOUR_API_KEY

​
Request

GET /api/v1/images/models/gpt-image-2/endpoints

​
Response

{
  "id": "gpt-image-2",
  "endpoints": [
    {
      "provider_name": "OpenAI",
      "provider_slug": "openai",
      "provider_tag": null,
      "supported_parameters": {
        "resolution": {
          "type": "enum",
          "values": ["1024x1024", "1024x768"],
          "default": "1024x1024"
        },
        "n": {
          "type": "range",
          "min": 1,
          "max": 4,
          "default": 1
        }
      },
      "allowed_passthrough_parameters": [],
      "supports_streaming": false,
      "pricing": [
        {
          "billable": "output_image",
          "unit": "image",
          "cost_usd": 0.06551,
          "resolution": "1024x1024"
        }
      ],
      "input_reference_constraints": {
        "max_items": 4,
        "route": {
          "min_width": 8,
          "min_height": 8,
          "max_bytes": 31457280,
          "formats": ["png", "jpeg", "webp"],
          "source": "route-preflight"
        }
      }
    }
  ]
}

​
Fields

FieldTypeDescription
idstringImage model ID.
endpointsarrayPublic endpoint metadata for the model. Currently one public endpoint is returned per model.
provider_namestringPublic provider display name.
provider_slugstringPublic provider slug.
provider_tagstring or nullCurrently null; provider selection is not exposed on this API surface.
supported_parametersobjectMachine-readable parameter metadata for this model endpoint.
allowed_passthrough_parametersarrayEmpty for now; provider passthrough is not supported.
supports_streamingbooleanCurrently false.
pricingarrayPublic NanoGPT pricing metadata. This is not provider at-cost pricing.
input_reference_constraintsobjectIncluded when the model supports image inputs.

​
Example

curl https://nano-gpt.com/api/v1/images/models/gpt-image-2/endpoints

​
Notes

  • Provider selection, provider passthrough options, and provider-specific endpoint choice are not supported yet.
  • pricing uses public NanoGPT pricing.
  • Check supported_parameters before deciding which request controls to show.