Skip to main content
POST
Run a Summer API job

Authorizations

Authorization
string
header
required

A Summer sign-in: an OAuth 2.1 access token, valid one hour. Sign in once with npx -y summer-engine login, then print a token with summer token. Each app you sign in spends your paid credits up to the limit you set in Connected apps.

Headers

Idempotency-Key
string
required

A new key for each new request; the same key returns the first answer.

Required string length: 1 - 128
Prefer
string

wait=<seconds, at most 60>: answer with the finished job when it finishes in time.

Example:

"wait=60"

Body

application/json
model
string
required

A Summer model id from models.list, such as 3d/hunyuan-3d or 3d/default.

Required string length: 1 - 120
input
object

The model's input, matching its inputSchema.

quoteId
string

From models.estimate: refuse to charge more than it quoted.

Required string length: 1 - 600
webhookUrl
string

Summer POSTs here once, signed, when the job finishes. Needs a signing secret: webhooks.rotate_secret.

Maximum string length: 2048

Response

Done.

job
object
required