{"openapi":"3.1.0","info":{"title":"贵数智能 Public Agent API","version":"1.0.0","description":"Anonymous GET queries. Checkout uses existing verified sessions and user payment confirmation. Enabled catalog entries are not upstream health checks."},"servers":[{"url":"https://llm-agent.cc"}],"security":[],"externalDocs":{"url":"https://llm-agent.cc/en/agent-guide"},"paths":{"/api/public/agent":{"get":{"operationId":"discover_agent_capabilities","description":"Discover this site's public task interfaces.","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["en","zh"]}}],"responses":{"200":{"description":"Successful read-only result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Discovery"}}}},"400":{"description":"Invalid, duplicate, empty or unsupported parameters / billing unit mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Model or plan is not in this market's public catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Live rates or current public plans are unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/public/models":{"get":{"operationId":"search_models","description":"Filter by model ID/provider, capability, advertised endpoint family, enabled status, numeric context or input CNY/1M budget. Missing limit preserves the full catalog; limit caps at 100.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":120}},{"name":"capability","in":"query","required":false,"schema":{"type":"string","enum":["text","vision","image"]}},{"name":"endpoint","in":"query","required":false,"schema":{"type":"string","enum":["openai","anthropic"]}},{"name":"availability","in":"query","required":false,"schema":{"type":"string","enum":["enabled","unavailable","unknown"]}},{"name":"min_context_tokens","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":1000000000}},{"name":"max_input_cny_per_1m","in":"query","required":false,"schema":{"type":"number","minimum":0,"maximum":1000000}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["en","zh"]}}],"responses":{"200":{"description":"Successful read-only result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Models"}}}},"400":{"description":"Invalid, duplicate, empty or unsupported parameters / billing unit mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Model or plan is not in this market's public catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Live rates or current public plans are unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/public/models/{modelId}":{"get":{"operationId":"get_model","description":"Read one market-filtered model; page_url always identifies a guide or catalog selection.","parameters":[{"name":"modelId","in":"path","required":true,"schema":{"type":"string","maxLength":200}},{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["en","zh"]}}],"responses":{"200":{"description":"Successful read-only result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelDetail"}}}},"400":{"description":"Invalid, duplicate, empty or unsupported parameters / billing unit mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Model or plan is not in this market's public catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Live rates or current public plans are unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/public/models/{modelId}/setup":{"get":{"operationId":"get_model_setup","description":"Get setup links and protocol paths. Unknown exact protocol support must be checked with a model-specific request.","parameters":[{"name":"modelId","in":"path","required":true,"schema":{"type":"string","maxLength":200}},{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["en","zh"]}}],"responses":{"200":{"description":"Successful read-only result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Setup"}}}},"400":{"description":"Invalid, duplicate, empty or unsupported parameters / billing unit mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Model or plan is not in this market's public catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Live rates or current public plans are unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/public/estimate":{"get":{"operationId":"estimate_model_cost","description":"Calculate CNY cost for current published rates. input_tokens INCLUDES cached_input_tokens; cached_input_tokens must not exceed input_tokens. Fixed billing uses calls and token billing uses token counts. Account quota is not model tokens. Additional/tiered charges are settled by actual billing.","parameters":[{"name":"model_id","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"input_tokens","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":1000000000}},{"name":"output_tokens","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":1000000000}},{"name":"cached_input_tokens","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":1000000000}},{"name":"calls","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":1000000}},{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["en","zh"]}}],"responses":{"200":{"description":"Successful read-only result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Estimate"}}}},"400":{"description":"Invalid, duplicate, empty or unsupported parameters / billing unit mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Model or plan is not in this market's public catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Live rates or current public plans are unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/public/purchase-quote":{"get":{"operationId":"get_purchase_quote","description":"Read current purchase/topup offers with checkout-market currency, integer minor amounts and quota units. Read expires_at; prices are not locked. Does not create an order. Continue using checkout_url, verify email, confirm payment, then verify delivery or credit separately.","parameters":[{"name":"intent","in":"query","required":false,"schema":{"default":"purchase","type":"string","enum":["purchase","topup"]}},{"name":"plan_code","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["en","zh"]}}],"responses":{"200":{"description":"Successful read-only result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Quote"}}}},"400":{"description":"Invalid, duplicate, empty or unsupported parameters / billing unit mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Model or plan is not in this market's public catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Live rates or current public plans are unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}},"Source":{"type":"object","required":["live","market","pricing_version","updated_at","reference_updated_at","feishu_revision"],"properties":{"live":{"type":"boolean"},"market":{"enum":["cn","global"]},"pricing_version":{"type":["string","null"]},"updated_at":{"type":"string"},"reference_updated_at":{"type":"string"},"feishu_revision":{"type":"integer"}}},"Model":{"type":"object","required":["id","availability","billing","page_url","docs_url","setup_url","health"],"properties":{"id":{"type":"string"},"provider":{"type":"string"},"availability":{"enum":["enabled","unavailable","unknown"]},"availability_basis":{"const":"pricing_catalog"},"health":{"const":"unknown"},"billing":{"type":"object","description":"CNY rates per 1M input/output/cache tokens or per fixed-billed call; null means unknown.","properties":{"unit":{"type":"string"},"input_cny_per_1m":{"type":["number","null"]},"output_cny_per_1m":{"type":["number","null"]},"cache_cny_per_1m":{"type":["number","null"]},"per_call_cny":{"type":["number","null"]}}},"context_window":{"type":["string","null"]},"context_window_tokens":{"type":["integer","null"]},"capabilities":{"type":"array","items":{"type":"string"}},"endpoints":{"type":"array","items":{"type":"string"}},"capability_status":{"type":"object"},"scores":{"type":"null"},"page_url":{"type":"string","format":"uri"},"docs_url":{"type":"string","format":"uri"},"setup_url":{"type":"string","format":"uri"}}},"Models":{"type":"object","required":["schema_version","source","models","total"],"properties":{"schema_version":{"const":"1"},"source":{"$ref":"#/components/schemas/Source"},"models":{"type":"array","items":{"$ref":"#/components/schemas/Model"}},"total":{"type":"integer"}}},"ModelDetail":{"type":"object","required":["schema_version","source","model"],"properties":{"schema_version":{"const":"1"},"source":{"$ref":"#/components/schemas/Source"},"model":{"$ref":"#/components/schemas/Model"}}},"Setup":{"allOf":[{"$ref":"#/components/schemas/ModelDetail"},{"type":"object","properties":{"base_url":{"type":"string"},"protocols":{"type":"array","items":{"type":"object"}},"verification":{"type":"string"},"tutorials":{"type":"object"},"next_steps":{"type":"object"}}}]},"Estimate":{"type":"object","required":["model_id","amount_cny","currency","estimate_only","source"],"properties":{"model_id":{"type":"string"},"source":{"$ref":"#/components/schemas/Source"},"currency":{"const":"CNY"},"amount_cny":{"type":"number","minimum":0},"estimate_only":{"const":true},"counts":{"type":"object"},"billing":{"type":"object"},"note":{"type":"string"},"page_url":{"type":"string"}}},"Quote":{"type":"object","required":["market","intent","observed_at","expires_at","offers","handoff","estimate_only"],"properties":{"market":{"enum":["cn","global"]},"intent":{"enum":["purchase","topup"]},"observed_at":{"type":"string"},"expires_at":{"type":"string"},"estimate_only":{"const":true},"payment_status":{"enum":["paused","confirm_at_checkout"]},"offers":{"type":"array","items":{"type":"object","required":["code","currency","amount_minor","account_quota","checkout_url"],"properties":{"code":{"type":"string"},"currency":{"type":"string"},"amount_minor":{"type":"integer"},"amount":{"type":"number"},"minor_unit_scale":{"const":100},"account_quota":{"type":"object"},"reference_amount":{"type":"object"},"checkout_url":{"type":"string","format":"uri"}}}},"handoff":{"type":"object","description":"Verification and payment confirmation are required. creates_order and charges_payment are false. Order initiation, payment, key delivery and quota credit must be checked separately."},"note":{"type":"string"}}},"Discovery":{"type":"object","properties":{"schema_version":{"const":"1"},"market":{"enum":["cn","global"]},"guide_url":{"type":"string"},"openapi_url":{"type":"string"},"endpoints":{"type":"object"},"tasks":{"type":"object"},"boundaries":{"type":"object"}}}}}}