Twitter 视频转文字
curl --request POST \
--url https://api.socq.ai/v1/x/post-transcript \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"urls": [
"<string>"
],
"callback_url": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/x/post-transcript"
payload = {
"urls": ["<string>"],
"callback_url": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({urls: ['<string>'], callback_url: '<string>'})
};
fetch('https://api.socq.ai/v1/x/post-transcript', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/x/post-transcript",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'urls' => [
'<string>'
],
'callback_url' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/x/post-transcript"
payload := strings.NewReader("{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/x/post-transcript")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/x/post-transcript")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}X
Twitter 视频转文字
把 X 视频里的语音转成文字。
POST
/
v1
/
x
/
post-transcript
Twitter 视频转文字
curl --request POST \
--url https://api.socq.ai/v1/x/post-transcript \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"urls": [
"<string>"
],
"callback_url": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/x/post-transcript"
payload = {
"urls": ["<string>"],
"callback_url": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({urls: ['<string>'], callback_url: '<string>'})
};
fetch('https://api.socq.ai/v1/x/post-transcript', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/x/post-transcript",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'urls' => [
'<string>'
],
'callback_url' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/x/post-transcript"
payload := strings.NewReader("{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/x/post-transcript")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/x/post-transcript")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"urls\": [\n \"<string>\"\n ],\n \"callback_url\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}Twitter 视频转文字
把 X 视频里的语音转成文字。传入带视频的帖子链接,即可返回纯文本形式的转录内容,以及视频时长(秒)。有了文字稿,视频内容就能检索、能引用:摘出采访片段里的原话、总结产品演示、翻译一段演讲,或者把口播内容放进你对文字帖子已有的分析流程里。{
"urls": [
"https://x.com/NASA/status/2119833829389041896"
]
}
标准结果字段
任务结果使用下方稳定的 SocQ 字段。系统会统一来源特有的字段名和格式,但不会推断或补充来源未提供的数据。如需缩小返回字段集合,MCP 查询使用fields,Typed 工具使用 _result_fields,CLI 使用 --result-fields。声明字段的值为 null 时仍会保留。
| 字段 | 类型 | 可空 | 说明 |
|---|---|---|---|
id | string | 是 | 当前结果项的唯一标识。 |
platform | string | 否 | 结果所属的平台,例如 instagram 或 linkedin。 |
resource | string | 否 | 该结果对应的 SocQ 资源,例如 videos 或 comments。 |
type | string | 否 | 结果项的类别,例如 video、post 或 comment。 |
url | string | 是 | 结果项的公开访问地址(如可获得)。 |
published_at | string | 是 | 源内容的发布时间(如可获得),使用 ISO 8601 格式。 |
collected_at | string | 否 | SocQ 采集或处理该结果的时间,使用 ISO 8601 格式。 |
text | string | 是 | 音频或视频内容的转录文本。 |
language | string | 是 | 转录文本的语言(如可获得)。 |
format | string | 是 | 转录结果的表示格式,例如纯文本或带时间片段。 |
duration_seconds | number | 是 | 时长,单位为秒。 |
任务完成响应
{
"code": 200,
"data": {
"task_id": "example-x-post-transcript",
"status": "succeeded",
"public_id": "x/post-transcript",
"result_count": 1,
"credits_amount": 0.7,
"results": {
"limit": 50,
"next_cursor": null,
"has_more": false,
"schema_id": "transcript",
"schema_version": "1.0",
"items": [
{
"id": "2119833829389041896",
"platform": "x",
"resource": "post-transcript",
"type": "transcript",
"url": "https://x.com/NASA/status/2119833829389041896",
"published_at": null,
"collected_at": "2026-11-13T10:15:28Z",
"text": "Welcome to Max Power. NASA lit the fires and hosted a four-day showcase of American excellence in air and space right here at Kennedy Space Center. At Up Summit, government and industry came together to align around the technology that will ensure American leadership across the most demanding and exciting domains: from cars that do not require roads, drones that deliver packages, and spacecraft that bring us closer to the stars. Then, AirDot Show took over the skies, bringing some serious American air power and inspiration to thousands of visitors across the Space Coast. And throughout it all, young people, the next generation, met astronauts, pilots, engineers. They saw the machines shaping our future and got a glimpse of the near-limitless world they will inherit. Max Power was only the beginning. With President Trump, we announced Cape Week: what will become the grandest exposition of aerospace technology the world has ever seen. And it begins in March 2028. America is building a new golden age of exploration and discovery, and now every child will have a front-row seat to the greatest adventure in human history.",
"language": null,
"format": "text",
"duration_seconds": 86.709
}
]
}
}
}
请求体
application/json
通过 urls 提供带视频的 X 帖子链接,路径格式为 /{用户名}/status/{帖子ID}。每个视频返回语音文字和时长。2 分钟以内的视频按 0.7 积分计费;超过 2 分钟的视频按完整时长每开始一分钟计 4 积分,例如 3 分钟的视频计 12 积分。不含视频的帖子不返回结果,也不扣积分。
带视频的 X 帖子链接,格式为 https://x.com/{用户名}/status/{帖子ID},至少提供 1 项。
Minimum array length:
1Minimum string length:
1
