-
Notifications
You must be signed in to change notification settings - Fork 265
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
New api docs structure #1379
New api docs structure #1379
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Very cool re-org!
Co-authored-by: Pedro Cuenca <[email protected]>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
🔥
Co-authored-by: Lucain <[email protected]>
* First draft for text-to-image * add correct code snippets * Update docs/api-inference/tasks/text-to-image.md Co-authored-by: Omar Sanseviero <[email protected]> * better table? * Generate tasks pages from script (#1386) * init project * first script to generate task pages * commit generated content * generate payload table as well * so undecisive * hey * better ? * Add image-to-image page * template for snippets section + few things * few things * Update scripts/api-inference/templates/specs_headers.handlebars Co-authored-by: Omar Sanseviero <[email protected]> * Update scripts/api-inference/templates/specs_headers.handlebars Co-authored-by: Omar Sanseviero <[email protected]> * generate * fetch inference status --------- Co-authored-by: Omar Sanseviero <[email protected]>
…b-docs into new_api_docs
It looks like you've updated documentation related to model or dataset cards in this PR. Some content is duplicated among the following files. Please make sure that everything stays consistent.
|
The docs for this PR live here. All of your documentation changes will be reflected on that endpoint. The docs are available until 30 days after the last update. |
Co-authored-by: Pedro Cuenca <[email protected]>
Co-authored-by: Lucain <[email protected]>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Given the size of the changes and the multiple PRs that got merged into it, I decided to review things in a local deployment of the docs. I opened a small PR to suggest changes: #1397.
* Filter out frozen models * use placeholder
* show as diff * reorder toctree * wording update * diff
* Add comment header on each task page * add huggingface.co/api/tasks
…classification (#1398) * Add token classification * add translation task * add zero shot classification * more parameters * More tasks more tasks more tasks! (#1399) * add ASR * fix early stopping parameter * regenrate * add audio_classification * Image classification * Object detection * image segementation * unknown when we don't know * gen * feature extraction * update
This PR should prove useful for the ongoing work of generating documentation pages based on the input/output specs (see huggingface/hub-docs#1379). In particular, I've made changes when adding new pages to the docs (PRs huggingface/hub-docs#1398 and huggingface/hub-docs#1399). This PR is now ready for review. **Changes:** - use enums instead of `oneOf` + list of `const` - do not rely on `"$ref": "/inference/schemas/text2text-generation/input.json",` for Summarization / Translation. Makes things clearer + it's not possible to extend the parameters which was not possible before. - typo in `text-to-image` - add `src_lang` and `tgt_lang` in translation params - use enum for `early_stopping` parameter (in common defs) - for `audio-classification`, `automatic speech recognition`, `image classification`, `image to image`, `object detection`: - mention `base64-encoded string` as input - mention raw data can be sent if no parameters in the JSON payload - more descriptions in `object detection` - more descriptions in `image segmentation` - mention bytes output in `text-to-image` and `image-to-image`
* Rename all tasks '_' to '-' * also for other urls
|
||
| User Tier | Rate Limit | | ||
|---------------------|---------------------------| | ||
| Unregistered Users | 1 request per hour | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
this is 0 no? for Unregistered Users
client.text_classification("Today is a nice day") | ||
``` | ||
|
||
## JavaScript |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
you're not using the tabs component to switch programming languages?
scripts/api-inference/templates/task/chat-completion.handlebars
Outdated
Show resolved
Hide resolved
Co-authored-by: Victor Muštar <[email protected]>
* Update getting started examples * Move snippets above specification * custom link for finegrained token
* Misc changes * Wrap up * Apply suggestions from code review * generate * Add todos to avoid forgetting about them --------- Co-authored-by: Lucain <[email protected]> Co-authored-by: Wauplin <[email protected]>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Time to merge!
(see discussion in private google docs)