HYhyperbrowser

Start a HyperAgent task

Changed on
post/api/task/hyper-agent

Request

Request body

taskstring required
version'0.8.0' | '1.1.0'
llm'gpt-6-luna' | 'gpt-5.6-luna' | 'gpt-5.5' | 'gpt-5.2' | 'gpt-5.1' | 'gpt-5' | 'gpt-5-mini' | 'gpt-4o' | 'gpt-4o-mini' | 'gpt-4.1' | 'gpt-4.1-mini' | 'claude-sonnet-5' | 'claude-sonnet-4-6' | 'claude-haiku-5-5' | 'gemini-2.5-flash' | 'gemini-3.8-flash' | 'gemini-3.7-flash' | 'gemini-3-flash-preview'

Older model names automatically select replacements, including gpt-4.1-nano to gpt-6-luna. See HyperAgent model mappings.

sessionIdstring
maxStepsnumber
keepBrowserOpenboolean
useCustomApiKeysboolean

Example request

{
  "sessionOptions": {
    "proxyCity": "new york"
  }
}

Response

HyperAgent task started successfully

jobIdstring required
liveUrlstring nullable

Changes

  • 466402067034Revision changes
    • breaking

      removed the enum value claude-sonnet-4-5 of the request property

    • info

      added the new gpt-6-luna enum value to the request property

  • 225d94fe61a0Revision changes
    • info

      added subschema #4 to the // request property oneOf list