---
title: "Test group channel preview"
method: POST
path: "/api/group/{group}/channel/test-preview"
tags: ["group-channel"]
---

# Test group channel preview

`POST /api/group/{group}/channel/test-preview`

## Request

- The document declares no server URL.
- Auth: API key in header `Authorization`

Test a single model in a group channel without saving to database

## Path parameters

- `group` string, required

## Query parameters

- `success_body` boolean

## Request body

- ControllerTestSingleGroupChannelRequest
  - `base_url` string
  - `configs` ModelChannelConfigs
  - `group_id` string
  - `key` string, required
  - `mode` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40
  - `model` string, required
  - `model_mapping` object
  - `name` string
  - `proxy_url` string
  - `request_body` integer[]
  - `sets` string[]
  - `skip_tls_verify` boolean
  - `type` integer, required

## Response `200`

OK

- object
  - `data` ModelGroupChannelTest
    - `actual_model` string
    - `channel_name` string
    - `channel_type` 1 | 3 | 4 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59
    - `code` integer
    - `group_channel_id` integer
    - `group_id` string
    - `mode` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40
    - `model` string
    - `response` string
    - `success` boolean
    - `test_at` string
    - `took` number
  - `message` string
  - `success` boolean

## Changes

- **2026-10-12** `c2f7f35df2f5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/labring/apis/ai-proxy-swagger-api/changes/api/group/:group/channel/test-preview/post.md)

---

[API](https://skmtc.dev/labring/apis/ai-proxy-swagger-api.md) - [All operations](https://skmtc.dev/labring/apis/ai-proxy-swagger-api/llms.txt) - [OpenAPI document](https://skmtc.dev/labring/apis/ai-proxy-swagger-api/revisions/c2f7f35df2f5?raw)