GET /models/{model_slug}

Returns the metadata of a model identified by its slug: exposed endpoints, name of the input multipart field (audio or image), optional boolean fields, accepted file extensions and pricing. Public endpoint — no API key required. 404 "Model not found." if the slug does not exist.

GET /models/{model_slug}

Request body

The following parameters can be included in the request body:

Parameters

model_slug

string

Required

Kebab-case slug of the model (e.g. alpha-audio-v1, alpha-digit-max, alpha-digit-medium).

Successful response

The following fields are returned in a successful response:

Response fields

model_slug

string

Required

Model selection

type

string

Required

Capability type: "audio" or "ocr".

display_name

string

Required

Commercial name of the model.

version

string null

Model version (may be null).

description

string

Required

Short description of the model.

endpoints

array<string>

Required

List of HTTP routes exposed for this model (method + path).

input_field_name

string

Required

Exact name of the expected multipart file field (e.g. "audio" or "image").

optional_fields

array<string>

Required

List of optional boolean fields accepted in the multipart.

accepted_extensions

array<string>

Required

Accepted file extensions (without the dot).

pricing

object

Required

Model pricing. Variable shape depending on type: {eur_per_hour, billing_unit, currency} for audio; {eur_per_1000_images, billing_unit, currency} for OCR.

Examples

Code examples for using this endpoint:

curl

curl -X GET "https://api-endpoints.alphaedge-ai.com/models/alpha-audio-v1"

python

import requests
r = requests.get(
    "https://api-endpoints.alphaedge-ai.com/models/alpha-audio-v1",
    timeout=30,
)
print(r.status_code, r.json())

typescript

const res = await fetch(
  "https://api-endpoints.alphaedge-ai.com/models/alpha-audio-v1"
);
console.log(res.status, await res.json());

Response

Sample API response:

json

{
  "model_slug": "alpha-audio-v1",
  "type": "audio",
  "display_name": "AlphaAudio v1",
  "version": "1.0",
  "description": "ASR haute précision optimisé pour le français.",
  "endpoints": [
    "POST /models/alpha-audio-v1/transcript"
  ],
  "input_field_name": "audio",
  "optional_fields": ["enable_diarization", "enable_postcorrect"],
  "accepted_extensions": ["mp3", "m4a", "wav", "flac", "ogg", "opus", "webm", "wma", "aiff", "aac", "aif"],
  "pricing": {
    "eur_per_hour": 0.15,
    "billing_unit": "audio_duration_seconds",
    "currency": "EUR"
  }
}