秦秦科技
开发者中心 / API 文档 / 快速开始
REST API · v1

秦科技开放 API

通过统一 API 调用秦科技的云计算、视觉识别、GPU 智算、网络加速、存储与安全能力。所有接口遵循 REST 规范，并使用 JSON 作为数据交换格式。

开始之前

请先注册账号并开通任一 API 套餐，在控制台创建 AccessKey。当前页面为产品外观演示，注册、登录与支付按钮不会产生实际操作。

服务地址

生产环境统一入口如下。平台会根据 region 参数自动路由至北京、上海、厦门、广州或成都节点。

BASE URLhttps://api.qin-tech.cn/v1
地域Region ID适用范围
北京cn-beijing华北及东北
上海cn-shanghai华东及长三角
厦门cn-xiamen海西及东南沿海
广州cn-guangzhou华南及大湾区
成都cn-chengdu西南及西部

身份鉴权

每次请求均需在 Header 中携带访问密钥、时间戳与 HMAC-SHA256 签名。请妥善保管 SecretKey，切勿将其写入公开代码。

X-QK-AccessKeystring · 必填

控制台生成的访问密钥 ID。

X-QK-Timestampstring · 必填

ISO 8601 格式的请求时间，允许 5 分钟时差。

X-QK-Signaturestring · 必填

使用 SecretKey 对规范请求串生成的签名。

创建视觉识别任务

下面使用 Go 语言创建一项异步视觉识别任务。将示例中的密钥与图片地址替换为实际值后即可发起请求。

Go
package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "io"
  "net/http"
)

func main() {
  payload := map[string]interface{}{
    "service": "vision.recognize",
    "region":  "cn-shanghai",
    "input": map[string]string{
      "image_url": "https://example.com/image.jpg",
    },
  }
  body, _ := json.Marshal(payload)
  req, _ := http.NewRequest(
    "POST",
    "https://api.qin-tech.cn/v1/tasks",
    bytes.NewBuffer(body),
  )
  req.Header.Set("Content-Type", "application/json")
  req.Header.Set("X-QK-AccessKey", "YOUR_ACCESS_KEY")
  req.Header.Set("X-QK-Signature", "YOUR_SIGNATURE")
  resp, err := http.DefaultClient.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  data, _ := io.ReadAll(resp.Body)
  fmt.Println(string(data))
}

返回结果

请求成功后将返回任务 ID。可通过 GET /v1/tasks/{task_id} 查询任务进度与最终结果。

Response · 202 Accepted
{
  "request_id": "req_01J8QK7F6P2KX9",
  "task_id": "task_7fe31c9a",
  "status": "processing",
  "region": "cn-shanghai",
  "created_at": "2026-08-15T10:30:00+08:00"
}

常见错误码

HTTP 状态码错误码说明
400InvalidParameter请求参数缺失或格式不正确
401SignatureMismatch签名校验失败或密钥无效
429RateLimitExceeded调用频率超过当前套餐限制
500InternalError服务内部异常，请稍后重试
下一篇任务状态查询 API →