跳到主要内容

Str_Array - 文本转数组

将单个字符串转换为数组格式，用于配合其他需要数组参数的API接口。

📋 功能说明​

Str_Array 是一个实用工具，用于将字符串转换为数组格式，主要用于单个素材的添加操作。

🌐 API调用​

接口地址​

POST https://jy-api.0x0.chat/v1/str_array.php

请求头​

Content-Type: application/json

📥 输入参数​

参数名类型必填说明
stringString✅待转换的文本内容

📤 输出参数​

参数名类型说明
arrayArray转换后的数组格式

💡 请求示例​

图片URL转换​

{
  "string": "https://example.com/image.jpg"
}

音频URL转换​

{
  "string": "https://www.coze.cn/test.mp3"
}

文字内容转换​

{
  "string": "欢迎使用剪映小助手"
}

📋 响应示例​

图片URL响应​

{
  "array": ["https://example.com/image.jpg"]
}

音频URL响应​

{
  "array": ["https://www.coze.cn/test.mp3"]
}

文字内容响应​

{
  "array": ["欢迎使用剪映小助手"]
}

🎯 使用场景​

单个图片添加​

graph TD
    A[图片URL] --> B[Str_Array<br/>转换为数组]
    B --> C[Add_Image<br/>添加图片]
// 步骤1：转换单个图片URL
{
  "string": "https://example.com/photo.jpg"
}

// 步骤2：使用转换后的数组
{
  "ids": "{{Create_Draft.ids}}",
  "images": "{{Str_Array.array}}",
  "timelines": [{"start": 0, "end": 5000000}]
}

单个音频添加​

// 步骤1：转换单个音频URL
{
  "string": "https://example.com/music.mp3"
}

// 步骤2：获取音频时长
{
  "links": "{{Str_Array.array}}"
}

// 步骤3：添加音频
{
  "ids": "{{Create_Draft.ids}}",
  "mp3_urls": "{{Str_Array.array}}",
  "timelines": "{{Get_Timelines.timelines}}"
}

单个文字添加​

// 步骤1：转换单个文字
{
  "string": "这是标题文字"
}

// 步骤2：添加文字
{
  "ids": "{{Create_Draft.ids}}",
  "texts": "{{Str_Array.array}}",
  "timelines": [{"start": 0, "end": 3000000}]
}

🔄 工作流集成​

典型使用模式​

graph TD
    A[单个素材] --> B[Str_Array<br/>格式转换]
    B --> C[Get_Timelines<br/>获取时长]
    B --> D[Add_*<br/>添加素材]
    C --> D

批量vs单个处理​

// 多个素材（无需转换）
{
  "images": [
    "https://example.com/img1.jpg",
    "https://example.com/img2.jpg",
    "https://example.com/img3.jpg"
  ]
}

// 单个素材（需要转换）
{
  "string": "https://example.com/single.jpg"
}
// 输出: {"array": ["https://example.com/single.jpg"]}

📊 支持的数据类型​

URL链接​

  • 图片链接 - JPG、PNG、GIF等
  • 音频链接 - MP3、WAV、M4A等
  • 视频链接 - MP4、MOV、AVI等
{
  "string": "https://cdn.example.com/media/file.mp4"
}

文本内容​

  • 标题文字 - 视频标题
  • 字幕内容 - 对话字幕
  • 标签文字 - 提示标签
{
  "string": "点击关注获取更多内容"
}

特效名称​

  • 动画特效 - 入场、出场动画
  • 视觉特效 - 滤镜、粒子效果
{
  "string": "渐显"
}

⚠️ 注意事项​

  1. 必要性检查：只有单个素材才需要使用 Str_Array
  2. 数据类型：输入必须是字符串类型
  3. 空值处理：不要输入空字符串或 null 值
  4. 编码问题：确保中文字符正确编码

🔧 故障排除​

Q: Str_Array 转换失败？ A: 检查输入字符串格式，确保不为空且类型正确。

Q: 转换后的数组格式不对？ A: Str_Array 只是简单的格式转换，不会修改内容本身。

Q: 什么时候不需要使用 Str_Array？ A: 当您已经有数组格式的数据时，直接使用即可。

💡 最佳实践​

何时使用​

// ✅ 需要使用 Str_Array 的情况
{
  "single_image": "https://example.com/one.jpg",
  "single_text": "单个文字内容",
  "single_audio": "https://example.com/voice.mp3"
}

// ❌ 不需要使用 Str_Array 的情况
{
  "multiple_images": [
    "https://example.com/img1.jpg",
    "https://example.com/img2.jpg"
  ]
}

工作流优化​

  1. 预处理阶段 - 在添加素材前完成所有格式转换
  2. 并行处理 - 多个 Str_Array 可以并行执行
  3. 复用结果 - 转换结果可以在多个节点中复用

🎯 相关功能​