Iflytek Image Understanding

Q: Why use Iflytek Image Understanding on TypingMind?

Because you install it once and use it with any model. Iflytek Image Understanding is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

Q: How do I install Iflytek Image Understanding in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/iflytek/iFly-Skills/tree/main/skills/iflytek-image-understanding. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Q: Which AI models can use Iflytek Image Understanding?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

Q: How many AI models can I use with Iflytek Image Understanding?

As many as you like. As long as a model supports skills, you can use Iflytek Image Understanding with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Q: Is the Iflytek Image Understanding AI skill free?

Yes. It is published on GitHub by iflytek under the Apache-2.0 license. You only pay your own AI provider for the tokens you use.

Q: What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

Q: How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

Organization

iflytek

iflytek-image-understanding

Use when user asks to analyze an image, describe image contents, or answer questions about a picture. iFlytek Image Understanding (图片理解) — analyze and answer questions about images using Spark Vision model. WebSocket API, pure Python stdlib, no pip dependencies.

Overview

Publisher	iflytek
Repository	`iFly-Skills`
Skill name	`iflytek-image-understanding`
Stars	212
Forks	23
Bundled files	2
License	Apache-2.0
Links	Skill source Repository

Markdown instructions
A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.
Works with any LLM
AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.
2 bundled files
Scripts, templates, and references the model can read while it works. Files are read-only and never executed.
Open source
Published by iflytek on GitHub. Read the source before you install it.

Installation

Install the Iflytek Image Understanding AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

Open the app and go to Plugins → Skills.
Choose "Install from GitHub".
Paste the skill folder URL below and confirm.
https://github.com/iflytek/iFly-Skills/tree/main/skills/iflytek-image-understanding
Enable the skill in any chat where you want it available.

Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills

git clone --depth 1 https://github.com/iflytek/iFly-Skills.git /tmp/iFly-Skills
mkdir -p .claude/skills
cp -r /tmp/iFly-Skills/skills/iflytek-image-understanding .claude/skills/iflytek-image-understanding

Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Iflytek Image Understanding in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Iflytek Image Understanding on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Iflytek Image Understanding is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

Loaded only when it is needed
The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.
Switch models mid-chat
Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

ifly-image-understanding

Analyze images and answer questions about their content using iFlytek's Spark Vision model (图片理解).

Setup

Create an app at 讯飞控制台 with 图片理解 service enabled

Set environment variables:

bash
export IFLY_APP_ID="your_app_id"
export IFLY_API_KEY="your_api_key"
export IFLY_API_SECRET="your_api_secret"

Usage

Describe an image

bash
python3 scripts/image_understanding.py photo.jpg

Ask a question about an image

bash
python3 scripts/image_understanding.py photo.jpg -q "图片里有什么动物？"

Use basic model (lower token cost)

bash
python3 scripts/image_understanding.py photo.jpg --domain general

Options

Flag	Short	Description
`image`		Image file path (.jpg, .jpeg, .png)
`--question`	`-q`	Question about the image (default: describe)
`--domain`	`-d`	`imagev3` (advanced, default) or `general` (basic, fixed 273 tokens/image)
`--temperature`	`-t`	Sampling temperature (0,1], default 0.5
`--max-tokens`		Max response tokens 1-8192, default 2048
`--raw`		Output raw WebSocket JSON frames

Examples

bash
# OCR a receipt
python3 scripts/image_understanding.py receipt.png -q "总金额是多少？"

# Identify objects
python3 scripts/image_understanding.py scene.jpg -q "图片中有哪些物体？"

# Low-cost basic model
python3 scripts/image_understanding.py chart.png -q "图表的趋势是什么？" -d general

Notes

Image formats: .jpg, .jpeg, .png
Max image size: 4MB
Max tokens: 8192 (input + output combined)
Auth: HMAC-SHA256 signed WebSocket URL
Endpoint: wss://spark-api.cn-huabei-1.xf-yun.com/v2.1/image
Pure stdlib: No pip dependencies — uses built-in socket + ssl for WebSocket
Model versions: imagev3 (advanced, dynamic token cost) vs general (basic, fixed 273 tokens/image)

错误码说明 😢

遇到错误先别慌～看看下面找到对应的解决方法吧！✨

错误码	错误信息	解决办法
0	🎉 成功	恭喜你！请求正常完成啦～
10003	用户的消息格式有错误	检查一下你的请求格式是否正确哦～确保发送的是合法的JSON格式呢！
10004	用户数据的schema错误	看起来数据结构有点问题～请检查一下字段名称和类型是否正确呀！
10005	用户参数值有错误	参数值可能不太对呢～仔细核对一下每个参数的有效范围吧！
10006	用户并发错误：同一用户不能多处同时连接	检测到重复连接啦！请确保只有一个客户端在连接同一个用户ID哦～
10013	用户问题涉及敏感信息，审核不通过	哎呀，你的问题可能包含了一些不太合适的内容～换个问题试试看吧！
10022	模型生产的图片涉及敏感信息，审核不通过	生成的图片没有通过审核呢...很抱歉，换张图片再试一下吧！
10029	图片任何一边的长度超过12800	图片尺寸太大啦！请确保图片宽高都不超过12800像素哦～
10041	图片分辨率不符合要求	图片尺寸不合适的呢～要求是：50×50 < 图片总像素值 < 6000×6000 哦！
10907	Token数量超过上限	内容太丰富啦！对话历史+问题的字数太多，需要精简一下输入哦～

💡 小贴士：如果还有其他问题，可以查看官方文档或者联系技术支持哦！

常见问题 🤔

图片理解的主要功能是什么呀？🐱

答：用户输入一张图片和问题，从而识别出图片中的对象、场景等信息，然后回答你的问题～是不是很方便呢！✨

图片理解支持什么应用平台呢？📱

答：目前支持 Web API 应用平台哦！直接在代码里调用就可以啦～

图片理解的文本大小限制多少呀？📝

答：有效内容不能超过 8192 Token 呢～如果超过了就要精简一下输入啦！

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

_meta.json1 KB
scripts/image_understanding.py16 KB

Frequently asked questions

What does the Iflytek Image Understanding AI skill do?

Why use Iflytek Image Understanding on TypingMind?

Because you install it once and use it with any model. Iflytek Image Understanding is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Iflytek Image Understanding in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/iflytek/iFly-Skills/tree/main/skills/iflytek-image-understanding. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Iflytek Image Understanding?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Iflytek Image Understanding?

As many as you like. As long as a model supports skills, you can use Iflytek Image Understanding with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Iflytek Image Understanding AI skill free?

Yes. It is published on GitHub by iflytek under the Apache-2.0 license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Adversarial Ux Test

NousResearch

OrganizationPopular

Roleplay a hostile user to find and triage UX pain points.

3 Statement Model

Build integrated IS/BS/CF financial workbooks in Excel.

Comps Analysis

Build comparable-company valuation workbooks in Excel.

Lbo Model

Build leveraged buyout workbooks with IRR/MOIC in Excel.

Iflytek Image Understanding

Overview

Installation

Install in TypingMind

Install in another agent

Use it in TypingMind

Works with any AI model

Skill instructions

ifly-image-understanding

Setup

Usage

Describe an image

Ask a question about an image

Use basic model (lower token cost)

Options

Examples

Notes

错误码说明 😢

常见问题 🤔

图片理解的主要功能是什么呀？🐱

图片理解支持什么应用平台呢？📱

图片理解的文本大小限制多少呀？📝

更多资源 📚

Bundled files

Frequently asked questions

Set up your own AI workspace now

Overview

Installation

Install in TypingMind

Install in another agent

Use it in TypingMind

Works with any AI model

Skill instructions

ifly-image-understanding

Setup

Usage

Describe an image

Ask a question about an image

Use basic model (lower token cost)

Options

Examples

Notes

错误码说明 😢

常见问题 🤔

图片理解的主要功能是什么呀？🐱

图片理解支持什么应用平台呢？📱

图片理解的文本大小限制多少呀？📝

更多资源 📚

Bundled files

Frequently asked questions

Related AI Skills

Set up your own AI workspace now