Upload cpp/ax650/include/ax_asr_api.h with huggingface_hub

cpp/ax650/include/ax_asr_api.h

@@ -16,6 +16,15 @@ extern "C" {
 
 #define AX_ASR_API __attribute__((visibility("default")))
 
+enum AX_ASR_STATUS_E {
+    AX_ASR_SUCCESS = 0,
+    AX_ASR_ERR_INVALID_ARGUMENT = -1,
+    AX_ASR_ERR_INIT_FAILED = -2,
+    AX_ASR_ERR_AUDIO_LOAD_FAILED = -3,
+    AX_ASR_ERR_RUN_FAILED = -4,
+    AX_ASR_ERR_NO_MEMORY = -5,
+    AX_ASR_ERR_STREAM_NOT_SUPPORTED = -6
+};
 
 // Supported asr
 enum AX_ASR_TYPE_E {
@@ -113,10 +122,56 @@ AX_ASR_API int AX_ASR_RunPCM(AX_ASR_HANDLE handle,
                    int num_samples,
                    int sample_rate,
                    const char* language,
-                   char** result);                   
+                   char** result);
+
+/**
+ * @brief Free transcription text returned by AX_ASR_RunFile/AX_ASR_RunPCM.
+ *
+ * @param result Buffer returned through the result output parameter.
+ */
+AX_ASR_API void AX_ASR_Free(char* result);
+
+/**
+ * @brief Initialize streaming recognition state. 
+ * Must be called before AX_ASR_StreamFeed.
+ * Clears accumulated audio features and resets partial results.
+ */
+AX_ASR_API int AX_ASR_StreamInit(AX_ASR_HANDLE handle);
+
+/**
+ * @brief Feed a chunk of audio data for streaming recognition.
+ * Accumulates features and runs incremental CTC inference.
+ * 
+ * @param handle ASR context handle
+ * @param pcm_data Float32 mono PCM data, range [-1.0, 1.0]
+ * @param num_samples Number of samples in this chunk
+ * @param sample_rate Sample rate of the audio (resampled to 16kHz internally)
+ */
+AX_ASR_API int AX_ASR_StreamFeed(AX_ASR_HANDLE handle,
+    float* pcm_data, int num_samples, int sample_rate);
+
+/**
+ * @brief Get the current partial streaming result.
+ * The returned string is allocated internally and freed on next StreamFeed or StreamReset.
+ * 
+ * @param handle ASR context handle
+ * @param result Pointer to receive partial transcription text. DO NOT free externally.
+ */
+AX_ASR_API int AX_ASR_StreamResult(AX_ASR_HANDLE handle, const char** result);
+
+/**
+ * @brief Flush the remaining streaming tail (dedicated streaming model only).
+ * Call this after feeding all audio to get the final partial result.
+ */
+AX_ASR_API int AX_ASR_StreamFinish(AX_ASR_HANDLE handle);
+
+/**
+ * @brief Reset streaming state (equivalent to StreamInit).
+ */
+AX_ASR_API int AX_ASR_StreamReset(AX_ASR_HANDLE handle);
 
 #ifdef __cplusplus
 }
 #endif
 
-#endif // _AX_ASR_API_H_
+#endif // _AX_ASR_API_H_