Create Model Session

Create a session with a provider using a model ID

POST https://api.mor.org/api/v1/session/modelsession

Create Model Session

cURL

curl --request POST \
  --url https://api.mor.org/api/v1/session/modelsession \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sessionDuration": 123,
  "directPayment": true,
  "failover": true
}
'

200

{
  "session_id": "<string>",
  "provider": "<string>",
  "model_id": "<string>",
  "bid_id": "<string>",
  "duration": 123,
  "cost": "<string>"
}

Create a session with a provider using a model ID and associate it with the API key.

This endpoint creates a session and automatically associates it with the API key used for authentication. Each API key can have at most one active session at a time. The system will automatically select the best available bid for the specified model.

Headers

Authorization · string · required

API key in format: Bearer sk-xxxxxx

Query Parameters

model_id · string · required

The blockchain ID (hex) of the model to create a session for, e.g., 0x1234...

Body

sessionDuration · integer · default: 3600

Duration of the session in seconds

directPayment · boolean · default: false

Whether to use direct payment instead of allowance

failover · boolean · default: false

Whether to enable automatic failover to another provider

Response

session_id · string

Unique identifier for the created session

provider · string

Provider address

model_id · string

Model identifier used

bid_id · string

Bid identifier that was selected

duration · integer

Session duration in seconds

cost · string

Total cost for the session

Automatic Bid Selection: When creating a session by model ID, the gateway automatically selects the best available bid based on price, provider rating, and availability. Use /api/v1/models/ratedbids?model_id=... to see all available bids first.

Before creating a session, ensure you have approved sufficient MOR tokens using the /api/v1/session/approve endpoint.

Enable failover: true for production applications to automatically switch to another provider if the primary provider becomes unavailable.