English

API quickstart

Create an API key, check available models, and quote your first ModelPort job.

Check the model catalog

Set your key as MODELPORT_API_KEY. Select a model with available: true for your account and inspect its parameters.

List models

curl "https://api.apimodel.store/v1/models" \
  -H "Authorization: Bearer $MODELPORT_API_KEY"

Use https://api.apimodel.store/v1 as the OpenAI SDK base URL. Use https://api.apimodel.store for the Anthropic SDK.

Review a quote

Replace the model and parameters in this example with ones available to you. A quote shows the platform charge before generation.

Quote a job

curl "https://api.apimodel.store/v1/quotes" \
  -H "Authorization: Bearer $MODELPORT_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"model":"nano-banana-2-1","prompt":"A ceramic cup in soft morning light.","parameters":{"resolution":"1K"}}'

Submit and track the job

Set max_price_usd to the most you agree to spend. Use a new idempotency key for each new job and reuse it when retrying the same request.

Submit after reviewing the price

curl "https://api.apimodel.store/v1/jobs" \
  -H "Authorization: Bearer $MODELPORT_API_KEY" \
  -H "Idempotency-Key: YOUR_UNIQUE_JOB_KEY" \
  -H "Content-Type: application/json" \
  --data '{"model":"nano-banana-2-1","prompt":"A ceramic cup in soft morning light.","parameters":{"resolution":"1K"},"max_price_usd":"0.05"}'

Set MODELPORT_JOB_ID to the returned id. Use the same API key when retrieving results or charges.

Check the job

curl "https://api.apimodel.store/v1/jobs/$MODELPORT_JOB_ID" \
  -H "Authorization: Bearer $MODELPORT_API_KEY"

Read the charge

curl "https://api.apimodel.store/v1/records/$MODELPORT_JOB_ID" \
  -H "Authorization: Bearer $MODELPORT_API_KEY"