Skip to main content

​
kira_signup

用户注册成功时触发（由 Supabase Edge Function 发送）。
属性类型说明
emailstring用户邮箱
namestring用户名称
触发流程:
  1. 用户通过 Supabase Auth 注册
  2. Supabase 触发 auth.users INSERT webhook
  3. signup-function Edge Function 发送事件到 PostHog

​
chat

用户发起 AI 对话时触发。
属性类型说明
thread_idstring对话线程 ID
modelstring模型: lite | nova | crazy | ultra

​
chat_completion

AI 对话完成时触发（业务埋点，成本由 ai_cost 事件追踪）。 触发时机: Agent onFinish 回调中
属性类型说明
thread_idstring对话线程 ID
modelstring模型名称
input_tokensnumber输入 token
output_tokensnumber输出 token
total_tokensnumber总 token
duration_msnumber耗时 (ms)
tool_callsnumber工具调用次数

​
ai_cost

统一的 AI 成本追踪事件，用于计算每个用户的 AI 使用成本。 触发时机:
  • agent: Agent onFinish 回调中
  • tool_llm: 工具内部 LLM 调用完成后 (如 readImage, imageEdit_styleCheck)
  • tool_image: 图片生成/编辑工具执行完成后
  • tool_compute: 按计算时间计费的工具执行完成后 (如 upscale)
  • tool_video: 视频生成完成后 (kira-be 和 kira-video-worker 均会发送)
  • tool_music: 音乐生成完成后 (kira-music-worker 发送)
属性类型说明
thread_idstring对话线程 ID
typestring成本类型: agent | tool_llm | tool_image | tool_compute | tool_video | tool_music
modelstring模型/服务名称
tool_namestring工具名称 (可选)
duration_msnumber耗时 (ms)
total_cost_usdnumber总成本 (美元)
LLM 类型额外属性 (agent / tool_llm):
属性类型说明
input_tokensnumber输入 token
output_tokensnumber输出 token
total_tokensnumber总 token
input_cost_usdnumber输入成本
output_cost_usdnumber输出成本
tool_callsnumber工具调用次数 (仅 agent)
图片类型额外属性 (tool_image):
属性类型说明
image_countnumber生成图片数量
cost_per_image_usdnumber单张图片成本
计算类型额外属性 (tool_compute):
属性类型说明
compute_time_secondsnumber计算时间 (秒)
cost_per_second_usdnumber每秒成本
视频类型额外属性 (tool_video):
属性类型说明
video_duration_secondsnumber视频时长 (秒)
cost_per_second_usdnumber每秒成本
音乐类型额外属性 (tool_music):
属性类型说明
music_duration_msnumber音乐时长 (ms)
music_cost_usdnumber音乐生成成本
cover_cost_usdnumber封面生成成本
lyrics_cost_usdnumber歌词对齐成本
价格表 (更新于 2026-03):
模型/服务类型价格来源
gpt-5.2-2025-12-11LLM1.75/1.75/14.0 per 1M tokensOpenAI
grok-4-1-fast-reasoningLLM0.2/0.2/0.5 per 1M tokensxAI
grok-4-1-fast-non-reasoningLLM0.2/0.2/0.5 per 1M tokensxAI
grok-3-mini-fastLLM0.3/0.3/0.5 per 1M tokensxAI
byteplus-seedream / seedream / seedream-edit图片$0.036/张BytePlus
gpt-image-1图片$0.063/张OpenAI
fal-kontext图片$0.04/张FAL
fal-flux-2-pro-edit图片$0.03/张FAL
fal-bria-eraser图片$0.04/张FAL
fal-bria-rmbg图片$0.018/张FAL
nano-banana-pro图片$0.15/张
illustrious图片$0.007/张Illustrious
google-gemini-flash-image / google-gemini-flash-image-gen图片$0.039/张Google
fal-esrgan计算$0.00111/秒FAL
seedance视频$0.05/秒BytePlus
grok视频$0.05/秒xAI
veo视频$0.15/秒Google
suno_unofficial / suno_instrumental / suno_add_vocals音乐$0.06/首 (12 credits)SunoAPI
suno-cover音乐封面$0/张 (免费)SunoAPI
suno-timestamped-lyrics歌词对齐$0.0025/次 (0.5 credits)SunoAPI
kira-be 中包含 tool_video 成本追踪代码（VideoCostParams 定义于 src/analytics/index.ts），但视频成本事件主要由 kira-video-worker 发送，因为 worker 拥有实际的 provider 响应数据（视频时长、最终成本）。 新增模型时务必同步更新 kira-be/src/analytics/index.ts 中的价格表，否则成本将记为 $0 并输出 console.warn。

​
tool_usage

工具调用时触发。所有 agent 工具均通过 withTracking() 包装，自动调用 trackToolUsage()。kira-video-worker 在视频生成完成后也会发送。
kira-be 中的 trackToolUsage() 函数被所有 agent 工具调用（通过 withTracking() 包装）。图片工具的成本追踪已迁移至 ai_cost 事件，但 tool_usage 仍会记录。
属性类型说明
thread_idstring对话线程 ID
tool_namestring工具名称
successboolean是否成功
duration_msnumber耗时 (ms)
credits_consumednumber消耗 credits
extraobject额外信息
error_messagestring错误信息
Credits 消耗:
工具Credits
generateImageWithAI5
removeBackground5
upscale5
eraser5
expand5
inpaintWithPrompt5
replaceBackgroundWithPrompt5
generateVideo (5s)60
generateVideo (10s)120
generateVideo (5s, veo)180
generateVideo (10s, veo)360
imageEdit (standard: Seedream/Flux)5
imageEdit (Max: Nano Banana Pro)20
redux5
inpaintWithImage5
replaceBackgroundWithImage5
generateMusic25
generateInstrumental25
addVocals25
googleSearch5
getFilterChoiceFromUser5
getAutoCropResultFromUser5
readImage0
initializeWithImage0
getMaskImageFromUser0
getExpandMaskImageFromUser0
generateVideo 额外属性 (kira-be):
属性类型说明
actionstringvideo_submit_success | video_submit_blocked
task_idstring视频任务 ID
video_durationstring视频时长 (秒)
reasonstring被拦截原因 (仅 blocked)
credits_requirednumber所需 credits (仅 blocked)
generateVideo 额外属性 (kira-video-worker): Worker 在视频生成的不同阶段发送 tool_usage 事件：
属性类型说明
task_idstring视频任务 ID
providerstring视频供应商: seedance | grok | veo
successboolean是否成功
duration_msnumber处理耗时 (ms)
credits_consumednumber消耗 credits (成功时)
error_messagestring错误信息 (失败时)

​
thread_created

创建对话线程时触发。
属性类型说明
thread_idstring线程 ID

​
feed_published

发布内容到 Feed 时触发。
属性类型说明
feed_idstringFeed ID
media_typestringimage | video | audio
image_id / video_id / audio_idstring原始内容 ID
feed_image_id / feed_video_id / feed_audio_idstringFeed 存储 ID
flagstring[]标记: ban | duplicate | nsfw

​
feed_deleted

删除 Feed 时触发。
属性类型说明
feed_idstringFeed ID
media_typestringimage | video | audio
image_idstring?原图 ID (图片类型)
feed_image_idstring?Feed 图片 ID (图片类型)
feed_video_idstring?Feed 视频 ID (视频类型)
feed_audio_idstring?Feed 音频 ID (音频类型)

​
subscription

订阅成功时触发。
属性类型说明
planstring订阅计划
firstboolean是否首次
intervalstring周期
amountnumber金额
currencystring货币

​
booster_purchase

购买加油包时触发。
属性类型说明
amountnumber金额
currencystring货币
creditsnumber获得 credits
booster_tierstring档位

​
subscription_canceled

取消订阅时触发。
属性类型说明
previous_planstring取消前的订阅计划
reasonstring取消原因
reason 枚举值:
值说明
canceled用户主动取消
incomplete订阅未完成
incomplete_expired订阅未完成已过期
past_due逾期未付款
paused订阅已暂停
unpaid未付款
deleted订阅已删除