---
title: "POST /v1/admin/channels"
method: POST
path: "/v1/admin/channels"
tags: ["ChannelAdminService"]
---

# POST /v1/admin/channels

`POST /v1/admin/channels`

===== Channel =====

## Request body

- ChannelV1CreateChannelRequest
  - `apiKey` string
  - `autoDisableJson` string
  - `baseUrl` string
  - `costRatio` string — 渠道成本倍率 decimal 字符串；空串=不配置（落 NULL）。非法值返回 400， reason=CHANNEL_COST_RATIO_INVALID。仅审计不计费。
  - `extraConfigJson` string
  - `headerOverrideJson` string — 覆盖三件套：与 ChannelInfo 同义；空串 = 未配置。写入前 biz 侧校验，不允许覆盖 stream 键。
  - `headerStripJson` string — header_strip_json 请求头剔除 JSON (对齐 ChannelInfo.header_strip_json)。
  - `modelMappingJson` string
  - `name` string
  - `paramOverrideJson` string
  - `passthroughBody` boolean
  - `priority` integer
  - `region` string
  - `remark` string
  - `retryJson` string
  - `timeoutMs` integer
  - `type` string
  - `vendorId` string

## Response `200`

OK

- ChannelV1CreateChannelReply
  - `channel` ChannelV1ChannelInfo — ChannelInfo 渠道展示模型；api_key 永远只回显 mask（"sk-****abcd"）。
    - `apiKeyMask` string
    - `autoDisableJson` string
    - `baseUrl` string
    - `costRatio` string — 渠道成本倍率 decimal 字符串（如 "0.8500"）；空串=未配置（快照 NULL）。仅审计不计费。
    - `createdAt` string, date-time
    - `extraConfigJson` string
    - `headerOverrideJson` string — header_override_json 请求头覆盖：{key: string | true} JSON；空/"{}" 表示未配置。 网关发往上游前 Set 到 HTTP header；支持 {api_key} / {client_header:Name} 模板变量 与 "*": true / "re:pat": true 通配 passthrough；不允许覆盖 stream 键。
    - `headerStripJson` string — header_strip_json 请求头剔除列表 JSON: '["X-Foo", "X-Bar"]'; 空/"[]"/"null" = 未配置。 与 header_override 独立字段, Phase 3 应用 (在 override 之后, 保证剔除优先级最高)。 大小写不敏感, 写侧 blocklist 拒绝 Content-Type / Host / Authorization 等协议关键头。
    - `id` string
    - `modelMappingJson` string
    - `name` string
    - `paramOverrideJson` string — param_override_json 请求参数覆盖：{key: any} JSON；空/"{}" 表示未配置。 网关发往上游前用 sjson 覆写请求体 JSON；不允许覆盖 stream 键。
    - `passthroughBody` boolean — passthrough_body true 时，网关直接把用户请求体透传给上游，不做任何 reshape。
    - `priority` integer
    - `region` string
    - `remark` string
    - `retryJson` string
    - `status` integer
    - `timeoutMs` integer
    - `type` string
    - `updatedAt` string, date-time
    - `vendorId` string

---

[API](https://skmtc.dev/apiqik/apis/apiqik-api.md) · [All operations](https://skmtc.dev/apiqik/apis/apiqik-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apiqik/apiqik-api/revisions/e06b96127408/schema)