Files

T

easyai 7c5a999e32 feat(api): 统一公开接口为 /api/v1 前缀

将通用生成、Gemini、可灵、火山、健康检查与 OpenAPI 的推荐入口统一到 /api/v1，并保留历史路径作为兼容别名。同步更新代理配置、接入文档、接口清单和前缀回归测试。\n\n验证：go vet ./...；go test ./...；pnpm openapi；pnpm lint；pnpm test；pnpm build；公开 OpenAPI 71 个方法与接口清单机器比对一致。

2026-07-22 08:48:32 +08:00

4.2 KiB

Raw Blame History

Model Runtime Acceptance Runbook

Before Changes

Record the target deployment and identity mode.
Confirm administrator identity with /api/v1/me.
Save current provider, base model, pricing rule set, policy set, platform, and platform-model JSON without secrets.
Confirm whether real upstream calls are allowed; otherwise use simulation.
Confirm upstream endpoint, auth, model name, capabilities, limits, pricing, and sync/async behavior from documentation.
Record which existing pricing rule and runtime policy were reused, or the exact semantic mismatch that required a new one.
For billing changes, save the current effective rule bindings, discounts, user-group policy, wallet balance, and one representative estimate response as described in model-billing-configuration-and-estimation.md.
Record the protocol compatibility decision and why the selected existing specType is sufficient, or the concrete gap that requires universal.
When one base model has different upstream names across platforms, confirm each binding resolves the expected providerModelName.

After Configuration

Read back:

/api/admin/catalog/providers
/api/admin/catalog/base-models
/api/admin/pricing/rule-sets
/api/admin/runtime/policy-sets
/api/admin/runtime/runner-policy
/api/admin/platforms
/api/admin/models

Verify that IDs and bindings resolve as intended and no unrelated record was removed or reset.

Catalog Verification

Use an authorized user JWT:

curl --fail-with-body \
  -H "Authorization: Bearer <user-jwt>" \
  "$GATEWAY_PUBLIC_API_BASE/model-catalog"

Confirm model alias, model types, provider source, effective capabilities, pricing summary, rate limits, permissions, and enabled state.

For pricing, verify the effective rule source and discount source rather than checking IDs only. Confirm whether the platform-model discount overrides the platform default, and compare the estimated or simulated amount with the intended price.

Use /api/v1/pricing/estimate for the first read-only calculation. A simulation request is a task execution path and may reserve and settle wallet billing; do not treat it as a read-only replacement for the estimate endpoint.

Execution Verification

Start with simulation:

curl --fail-with-body \
  -H "Authorization: Bearer <user-jwt-or-approved-api-key>" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "<model-alias>",
    "messages": [{"role":"user","content":"Reply with OK"}],
    "runMode": "simulation",
    "simulation": true,
    "stream": false
  }' \
  "$GATEWAY_PUBLIC_API_BASE/chat/completions"

Simulation verifies Gateway routing, permissions, parameter normalization, pricing, and task behavior, but it does not execute the real universal submit or poll scripts. Validate universal scripts separately against a local mock or approved provider test environment before enabling production traffic.

For media or universal scripts, inspect:

/api/workspace/tasks/{taskID}
/api/workspace/tasks/{taskID}/events
/api/workspace/tasks/{taskID}/param-preprocessing
/api/admin/runtime/model-rate-limits
/api/admin/runtime/rate-limit-windows

With explicit approval, run one real minimal request and verify upstream request ID, normalized output, task completion, billings, billingSummary.totalAmount, finalChargeAmount, and the wallet task_billing transaction. Explain any expected estimate difference caused by actual token usage, cached input, generated media duration/audio, preprocessing, or failover to another platform.

Rollback

Restore the prior complete resource body with PATCH.
Restore an individual platform-model binding through POST.
Use full platform-model PUT only when the saved list is complete and replacement is intentional.
Remove newly created resources in reverse dependency order only after explicit confirmation.
Use runtime restore only after the upstream problem is resolved.

Final Report

Report resource IDs, before/after behavior, requests used for verification, simulation or real mode, billing evidence, remaining risks, rollback readiness, and whether /api/v1/openapi.json was used. Never include credentials or raw secret-bearing payloads.

4.2 KiB Raw Blame History