Quickstart

Create an API key and run your first image, video or music task in a few minutes.

Create an API key

Create keys in the console with a name and expiration, including no expiration. New keys include all standard API permissions and can be viewed again after signing in. Never put keys in client-side code or public repositories.

Create an API key

Send your first request

Create an API key, export it as HERMES_API_KEY, and run this request. It is generated from the schema of nano-banana-pro-text-to-image-economy.

shell

export HERMES_API_KEY=your_api_key

# 1. Submit the task (asynchronous; returns 202 with a task id)
curl -X POST https://api.hermes-ai.net/api/v1/jobs \
  -H "Authorization: Bearer $HERMES_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "nano-banana-pro-text-to-image-economy",
  "input": {
    "prompt": "A lighthouse on a rocky coast at sunrise, soft light",
    "resolution": "1k"
  }
}'

# 2. Poll until status is succeeded, failed or reconciliation_required
curl https://api.hermes-ai.net/api/v1/jobs/TASK_ID \
  -H "Authorization: Bearer $HERMES_API_KEY"

Call another model

To call another model, change model and input. Each model page has its own examples: Browse models